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1.  Introduction 


Unattended  ground  sensors  (UGSs)  come  in  many  shapes  and  sizes  and  often  have 
many  different  components.  These  components  range  from  infrared  cameras  and 
magnetometers  to  communications  equipment  and  embedded  computers.  The 
combination  of  these  different  components  requires  sophisticated  software  that  is 
often  time  consuming  to  develop  and  difficult  to  reuse.  The  US  Army  Research 
Laboratory  (ARL)  and  the  Defense  Intelligence  Agency  created  the  Open  Standards 
for  Unattended  Sensors  (OSUS)1  to  simplify,  streamline,  and  improve  the 
reusability  of  UGS  software.  Based  on  OSGi,*  OSUS  allows  for  the  seamless  reuse 
of  one  component  in  multiple  systems,  significantly  reduces  development  time, 
creates  less  complex  source  code,  and  results  in  a  more  maintainable  software 
project.  Furthermore,  implementing  an  OSUS  controller  as  the  central  processing 
platform  of  any  smart  sensing  device  allows  for  seamless  reuse  and  replacement  of 
underlying  sensors,  fast  and  simple  mission  reprogramming  or  repurposing,  built- 
in  communication  between  systems,  and  several  methods  of  data  exfiltration 
already  implemented  and  available.  This  report  is  a  practical  guide  that  1)  provides 
a  basic  overview  of  the  necessary  programmatic  background  to  understand  OSUS 
and  the  underlying  OSGi  functionality,  2)  presents  examples  to  solidify  important 
concepts,  and  3)  gives  a  walkthrough  of  a  typical  plug-in  development’s  life  cycle. 

The  reference  documentation  and  source  code  are  located  at  the  following  links: 

•  https://github.com/ssg-udri/OSUS-R/releases 

•  https://github.com/ssg-udri/OSUS-R 

For  those  with  a  Common  Access  Card  or  Personal  Identity  Verification,  more 
OSUS  material  can  be  found  at  these  links: 

•  https://confluence.di2e.net/display/OSUS/OSUS+ffome 

•  https://bitbucket.di2e.net/proiects/OSUS/repos/osus-r/browse 

This  guide  provides  a  walkthrough  of  3  plug-ins:  FakeTripwire,  Sample  Consumer, 
and  Edge  Detector.  FakeTripwire  (com.acme.assets. simple  FakeTripwire)  is  an  asset 
that  randomly  generates  OSUS  detections,  similar  to  that  of  a  camera  or  other  sensor. 
Sample  Consumer  (com.acme.sampleConsumer)  is  able  to  receive  persisted 
observations,  and  the  Edge  Detector  (mil.arl.alg.edgeDetector)  is  able  to  receive 
persisted  images,  process  them,  and  then  persist  the  resulting  image.  For  best 


The  Open  Source  Gateway  Initiative  (OSGi)  specification  implements  and  describes  a  complete, 
dynamic,  modular  component  and  service  model  for  the  Java  programming  language.2,3 
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results,  have  a  copy  of  these  projects  for  reference  while  proceeding  through  this 
guide,  as  they  will  be  heavily  referenced.  The  average  time  needed  to  work  though 
this  document  as  intended  is  less  than  1  day. 

1.1  The  OSUS  Advantage 

Using  OSUS  as  the  core  of  any  smart  sensing  device  includes  all  of  the  benefits 
mentioned  in  the  introduction,  as  well  as  providing  access  to  all  of  the  previous 
work  implemented  in  OSUS.  Specifically,  things  such  as  radio-  or 
satellite-communication  plug-ins  (modular  functionality  expansion  parts  of  OSUS) 
are  available  for  use  and  give  the  developer  the  ability  to  use  these  communication 
means  by  simply  creating  a  configuration  file.  If  multiple  systems  are  in  use,  OSUS 
gives  seamless  communication  between  the  units.  Changing  the  application  of  the 
system  is  fast  and  simple  with  the  different  methods  OSUS  makes  available  for 
programming  specific  missions  or  objectives  into  the  system.  Lastly,  any  sensor 
that  has  an  OSUS  plug-in  can  be  swapped  into  the  system  seamlessly.  For  example, 
if  a  camera  becomes  available  with  higher  resolution  than  the  one  currently  in  use, 
swapping  this  into  an  OSUS  system  requires  little  (if  any)  code  change  to  take 
advantage  of  the  new  camera. 

1.2  This  Guide  vs.  Other  OSUS  Documentation 


This  report  is  more  basic  than  most  other  available  OSUS  documentation  and  more 
of  a  “getting  started  guide”.  It  will  heavily  reference  the  other  OSUS  documentation 
and  attempt  to  guide  you  in  finding  more  specific  details  if  necessary.  Table  1 
summarizes  each  of  the  currently  available  OSUS  documents. 

Table  1  Comparison  of  OSUS  documentation 


Document 

Description 

OSUS  plug-in  guide4 

Contains  a  vast  amount  of  specific  information  on  standard 
plug-in  development,  but  requires  background  knowledge  of 
OSGi  functionality  to  fully  comprehend 

OSUS  standard1 

A  detailed  description  of  the  OSUS  standard  and  good 
reference. 

OSUS  mission  programming 
guide5 

Details  how  to  configure  OSUS  for  missions — out  of  the 
scope  of  this  report. 

OSUS-R  operator 
instructions6 

A  guide  on  how  to  install,  configure,  operate,  and  interact  with 
OSUS 

OSUS  remote  interface 
specification7 

A  defined  protocol  for  interacting  with  an  OSUS  controller — 
out  of  the  scope  of  this  document 

A  Practical  Guide  to  the  Open 
Standard  for  Unattended 
Sensors  ( OSUS) 

(this  report) 

Basics  of  OSGi  and  OSUS,  provides  definitions  and  an 
introduction  by  example 
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1.3  The  OSUS  Controller 


At  a  very  high  level,  OSUS  comprises  a  controller  and  plug-ins.  The  controller  is 
the  core  piece  of  software  that  provides  a  means  of  communication  and 
management  for  plug-ins.  Plug-ins  are  added  to  the  controller  to  extend  the 
system’s  functionality. 

A  running  version  of  OSUS  is  needed  for  this  tutorial.  For  information  on  how  to 
install,  launch,  and  interact  with  OSUS,  see  Sections  3,  5.2,  and  6.2  of  OSUS 
Operator  Instructions .6 

1.4  Preparing  an  Integrated  Development  Environment  (IDE) 

OSUS  plug-in  development  can  be  done  from  any  IDE;  however,  Eclipse  is  highly 
recommended.  For  a  more  detailed  description  of  setting  up  eclipse,  getting  the 
necessary  add-ons  (bndtools — the  tools  needed  to  build  OSGi  bundles),  and  using 
the  OSUS  software  development  kit  (SDK),  see  Sections  5.1,  5.2,  and  5.4  of  the 
OSUS  Plug-in  Guide.4 

As  OSUS  plug-ins  become  more  complicated,  having  an  OSUS  environment  within 
Eclipse  that  allows  for  debugging  becomes  increasingly  important.  Follow  the 
instructions  found  in  Section  5.9  of  the  plug-in  guide4  to  set  up  an  OSUS  controller 
within  Eclipse  that  will  allow  for  normal  debugging. 

2.  OSUS 


OSUS  was  built  on  top  of  Apache  Felix8 — Apache’s  implementation  of  OSGi. 
OSUS  uses  this  specification  to  ensure  each  system  developed  for  OSUS  will  work 
with  any  other  system.  The  OSUS  Standard  was  then  built  on  top  of  this,  including 
a  data  model  that  allows  for  intelligent  interactions  among  different  parts  of  the 
OSUS  system,  specific  to  the  goals  and  duties  of  sensors. 

A  plug-in  and  a  bundle  are  the  same  thing.  Plug-in  is  the  typical  OSUS  terminology, 
and  bundle  is  the  typical  OSGi  terminology.  This  document  will  use  plug-in  and 
bundle  interchangeably.  A  plug-in  is  a  jar  file  that  contains  all  of  the  necessary 
methods  to  interact  with  OSGi  (and,  by  extension,  OSUS).  Plug-ins  are  the  modular 
part  of  the  system,  consuming  and  providing  services  that  allow  any  OSUS 
controller  to  communicate  with  the  plug-in  or  its  underlying  device. 


*  This  is  for  historical  reasons.  Early  iterations  of  the  project  that  became  OSUS  were  based  on  a  custom 
module  framework  that  used  the  term  “plugin”.  When  the  system  was  redesigned  to  use  OSGi,  the  old 
terminology  remained  in  use. 
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In  order  to  get  such  a  modular  piece  of  code  to  work  with  the  rest  of  the  system, 
specific  methods,  services,  and  protocols  must  be  followed.  The  following  sections 
will  step  through  the  most  important  elements  needed  for  proper  plug-in  operations. 
Later  sections  will  provide  a  walkthrough  of  existing  plug-ins  to  show  the  proper 
implementation  of  these  methods.  The  information  found  here  represents  the 
minimum  knowledge  needed  to  create  OSUS  plug-ins  proficiently. 


2.1  Plug-in  Types  and  the  OSUS  SDK 


Several  different  types  of  OSUS  plug-ins  exist,  but  they  all  fall  into  one  of  3 
categories:  Asset,  Communication,  or  Extension.  Asset  plug-ins  are  used  for 
sensors  and  do  things  such  as  capture  data,  execute  commands,  and  post 
observations.  Communication  plug-ins  are  used  to  provide  physical,  link,  or 
transport  layer  support.  Asset  plugs  often  use  a  communication  plug-in  as  a 
middleman  between  the  asset  and  the  OSUS  controller.  Lastly,  extension  plug-ins 
are  used  for  anything  else.  This  can  include,  but  it  not  limited  to,  algorithms,  fusion, 
and  exfiltration.  Figure  1  is  a  good  graphical  representation  of  the  different  types 
of  plug-ins. 


Bundle  (OSGi  term) 

Java  software  module  conformingto  OSGi  application  programming  interfaces  (APIs) 


Plugin 

OSGi  module  conformingto  OSUS  APIs -essentially,  the  OSUS  word  for  "bundle" 


Asset  plugin 

Talks  to  sensor  hardware 

•  Captures  data 

•  Executes  commands 

•  Posts  observations 

•  Uses  comms  plugins  to  talk  to 
hardware 


Extension  plugin 

Catchall  term  for  plugins  that  don't  fall  into 
the  other  categories 

•  Uses  available  OSUS  and  OSGi 
functions  to  do  cool  stuff 

•  Algorithms 

•  Fusion 

•  Exfiltration 

•  Other  system  behaviors 


Custom  comms  plugins 


Physical  link 

Provides  access  to  I/O  ports  such  as  RS232 
and  SPI 

•  Reads  bytes 

•  Writes  bytes 

Link  layer 

Talks  to  non-IP  radios 

•  Sends  and  receives  packets 

•  Handles  addressing 

•  I nteracts  with  physical  link 

Transport  layer 

Implements  protocols 

•  Reads  and  writes  messages 

•  May  handle  addressing 

•  Interacts  with  link  layer 


Fig.  1  Different  types  of  plug-ins 

Templates  for  different  plug-in  types  are  found  in  the  OSUS  SDK  located  here: 
https://  github.com/ssg-udri/OSUS-R/releases/download/1 . 1  ■0/sdk-app-eneric.zip. 

For  more  information  on  the  SDK,  including  how  to  create  plug-in  templates,  see 
Section  5.1  of  the  OSUS  Plug-in  Guide. 
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2.2  Declarative  Services  and  Annotations 


The  backbone  of  getting  the  proper  operation  from  OS  US  is  OSGi  declarative 
services  and  annotations.  OSUS  defines  a  number  of  standard  services  that  can  be 
provided  or  consumed  by  plug-ins.  Plug-ins  use  annotations  to  indicate  which 
services  that  plug-in  provides  or  consumes.  The  build  system  (bndtools)  reads  these 
annotations  to  generate  a  declarative  services  Extensible  Markup  Language  (XML)  file, 
which  is  used  internally  by  the  OSGi  runtime  to  link  the  appropriate  services  together  as 
plug-ins  are  loaded.  More  information  can  be  found  at 
http://felix.apache.org/documentation/subproiects/apache-felix-maven-scr-plugin/ 

apache-felix-maven-scr-plugin-use.html  and  https://osgi.org/download/r5/osgi. 
cmpn-5.0.0.pdf. 

There  is  a  set  list  of  annotations  that  must  be  used  to  properly  create  a  plug-in  and 
to  extend  its  functionality  to  other  parts  of  the  system.  These  annotations  (such  as 
©Component  or  @Activate)  will  be  discussed  in  Section  2.6  and  during  the 
walkthroughs. 

2.3  Log  Services,  Event  Admin,  and  Configuration  Admin 

The  OSGi  implementation  that  OSUS  uses  is  Apache  Lelix.  As  part  of  this 
implementation,  some  Log  services  are  provided  along  with  an  Event  Admin  and  a 
Configuration  Admin.  The  Log  services  provided  are  relatively  standard  and  are 
not  described  here,  but  examples  can  be  seen  in  the  walkthroughs. 

Event  Admin  provides  a  means  for  interservice  and  interplug-in  communication, 
allowing  plug-ins  to  distribute  their  events  throughout  the  system  or  to  receive 
events  from  other  plug-ins.  The  walkthrough  will  describe  the  use  and  functionality  of 
the  Event  Admin.  If  more  information  on  the  Event  Admin  is  needed,  see  the 
documentation  found  here:  http ://felix . apache.org/ documentation/subproj ects/apache- 
felix-event-admin.html. 

Configuration  Admin  is  used  to  handle  the  configuration  and  attributes  of  each 
plug-in.  Each  plug-in  denotes  a  specific  set  of  variables  that  can  be  updated  by  the 
user  or  another  part  of  the  system;  when  changes  are  made  to  these  variables, 
Configuration  Admin  makes  them  available  to  the  plug-in.  The  OSUS 
implementation  of  this  allows  the  configuration  attributes  to  be  modified  from 
OSUS-SG,  the  standard  graphical  user  interface  (GUI).  This  provides  a  convenient 
way  for  an  operator  of  the  system  to  modify  plug-ins. 
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2.4  Factories,  Observations,  and  the  Observation  Store 


Services  within  OSGi  can  be  implemented  as  either  standard  objects  or  factory 
objects.  There  can  be  at  most  one  instance  of  a  standard  object,  whereas  any  number 
of  instances  of  a  factory  object  can  be  created.  For  example,  asset  plug-ins  are 
implemented  as  factory  objects,  as  multiple  physical  instances  of  an  asset  may  be 
connected  to  a  controller  and  one  instance  of  the  asset  plug-in  must  be  created  for 
each  connected  physical  asset.  On  the  other  hand,  the  observation  store  (described 
below)  is  implemented  as  a  standard  service  as  there  is  only  one  for  the  controller 
and  all  plug-ins. 

“Observation”  is  an  OSUS-defined  object  that  can  hold  digital  media  (images, 
video,  audio  files,  etc.),  metadata  about  the  capturing  device  and  the  media  itself, 
detections,  or  status  messages.  Most  OSUS  media  and  data  are  stored  and 
transferred  in  the  form  of  observations.  These  observations  are  persisted  with  the 
observation  store,  and  EventAdmin  is  used  to  notify  other  plug-ins  of  new 
observations  as  they  are  posted  to  the  store.  The  observation  store  is  a  storage 
mechanism  for  observations  that  can  be  queried  for  any  observation  at  any  time 
from  any  component  (as  long  as  it  has  a  reference  to  it). 

The  OSUS  observation  data  structures  are  defined  as  XML  Schema  Definition 
(XSD)  files,  but  can  also  be  represented  as  Java  classes  and  Protocol  Buffers 
messages  (see  https://developers.google.com/protocol-buffers/  for  more  details  on 
Protocol  Buffers).  Both  of  these  representations  are  generated  automatically  from 
the  XSD  files,*  and  observations  can  be  converted  between  any  of  these 
representations  without  loss  of  fidelity.  Generally,  the  controller  handles 
observations  as  Java  classes,  converting  them  to  XML  for  validation  and  to  Protocol 
Buffers  for  transmission  over  a  network.  OSUS  performs  schema  validation  on 
persisted  observations.  The  best  way  to  ensure  that  the  persisted  observation  is 
valid,  or  to  see  exactly  what  objects  are  supported,  is  by  looking  through  the  XML 
schema.  The  mil.dod.th.core.schema.zip  file  provided  with  the  OSUS  binary 
distribution  contains  the  schema  files,  or  they  can  be  found  at  the  following  location 
within  the  controller  source  code: 

osus-r\mil.dod.th.core.lexicon\schemas\core\observation\types\ 

The  top-level  schema  definition  for  Observation  objects  can  be  found  in  the 
Observation.xsd  file. 


The  Java  classes  are  generated  using  JAXB.  The  Protocol  Buffers’  definitions  are  generated  from  the 
JAXB  annotated  classes  using  custom  tools.  These  tools  are  included  with  the  OSUS  source  distribution. 
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2.5  Attributes  and  Configuration  Management 


Each  plug-in  has  an  attributes  file.  This  file  is  used  to  declare  variables,  which  can 
be  edited  by  other  parts  of  the  system,  including  an  operator  through  OSUS-SG 
(Standard  GUI).  This  will  be  shown  and  discussed  in  more  detail  in  the 
walkthrough. 

Assets  have  a  capabilities-xml  file.  This  file  details  the  capabilities  of  each  plug-in 
in  terms  of  the  functionality  it  provides.  A  plug-in  may  not  behave  properly  if  this 
file  is  not  properly  set  up.  An  example  of  this  will  be  shown  in  the  FakeTripwire 
walkthough.  The  XSD  files  defining  the  expected  capabilities  file  can  be  found  at 

osus-sdk\mil.dod.th.core.lexicon\schemas\core\asset\capabilities\ 

and 

osus-sdk\mil.dod.th.core.lexicon\schemas\core\capability\. 

2.6  Plug-in  Life  Cycle 

The  high-level  life  cycle  of  an  OSGI  bundle  is  activation,  modification,  and 
deactivation. 

When  all  of  a  bundle’s  dependencies  are  met,  the  activate  method  is  called  to 
initialize  the  services  provided  by  that  bundle.  If  at  any  time  the  bundle’s 
configuration  is  changed,  the  modified  method  is  called  to  update  the 
configurations  appropriately.  When  the  bundle  is  stopped,  or  when  its  dependencies 
are  no  longer  met,  the  deactivate  method  is  called  to  shut  down  the  bundle’s 
services. 

OSUS  assets  and  communications  plug-ins  have  an  additional  activate-deactivate 
life  cycle  that  exists  side  by  side  with  the  OSGI  activation-deactivation  life  cycle. 
Asset  activation  and  deactivation  occurs  on  command  (initiated  by  either  a  user  or 
another  plug-in),  in  contrast  with  bundle  activation  that  occurs  automatically 
whenever  a  bundle  is  loaded  and  its  dependencies  are  satisfied.  The  extended  life 
cycle  is  initialization  (corresponding  to  bundle  activation),  asset  activation, 
modification,  asset  deactivation,  and  bundle  deactivation.  Asset  activation  and 
deactivation  may  occur  multiple  times  during  a  component’s  lifespan. 


*  This  highly  unfortunate  terminology  conflict  exists  for  historical  reasons.  As  previously  noted,  early 
versions  of  OSUS  were  based  on  a  custom  module  framework,  and  the  terms  “activate’"  and  “deactivate” 
were  adopted  for  use  within  this  custom  framework.  When  the  custom  framework  was  replaced  with  OSGi, 
the  old  terms  were  not  changed  and  the  conflict  with  the  identically  named  but  semantically  different  OSGi 
terminology  was  introduced. 
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By  contrast,  extension  plug-ins  interact  directly  with  the  OSGi-bundle  life  cycle. 
These  plug-ins  provide  their  own  activate,  modified,  and  deactivate  methods  that 
must  be  annotated  with  @  Activate,  @Modified,  and  ©Deactivate  annotations. 2,9,10 
(These  annotations  must  not  be  used  on  asset  or  communications  plug-ins  or 
unexpected  behavior  will  occur.) 

Table  2  shows  the  comparison  of  OSGi  and  OSUS  method  names  and  a  description 
of  each  step.  This  will  be  revisited  in  the  walkthroughs. 


Table  2  Comparison  of  OSGi  and  OSUS  life-cycle  terminology 


OSGi 

annotation 

OSGi 

method 

OSUS  asset 
method 

Description 

@  activate 

Activate 

Initialize 

Creates  the  plug-in  instance. 

onActivate 

OSUS  specific;  sets  the  plug-in  ready  to 
capture,  generate,  or  receive  data  (running 
state). 

@  modified 

Modified 

Updated 

Informs  the  plug-in  of  configuration 
changes. 

onDeactivate 

OSUS  specific;  sets  the  plug-in  not  ready  to 
capture,  generate,  or  receive  data  (paused 
state). 

©deactivate 

Deactivate 

Shuts  down  the  plug-in  when  it  is  stopped 
or  its  dependencies  are  no  longer  met. 

2.7  Mission  Programming 

This  mission  programming  of  OSUS  is  out  of  the  scope  of  this  paper;  however,  the 
OSUS  Mission  Programming  Guide 5  provides  excellent  detail  on  this  topic.  The 
JavaScript  method  described  in  the  aforementioned  document  is  not  the  only  method 
of  OSUS  mission  programming.  Another  common  method  is  to  create  a  plug-in  that 
acts  as  the  mission  program.  An  example  would  be  a  plug-in  that  waits  for  a  specific 
detection  and  then  triggers  the  camera  to  take  a  picture.  Both  methods  can  be  made 
to  accomplish  any  task  and  be  easily  swapped  for  a  new  mission  program  or 
objective. 

3.  Plug-in  Walkthrough 

This  section  of  the  report  provides  an  analysis  and  discussion  of  2  existing  plug-ins 
to  show  the  typical  composition  of  both  a  plug-in  that  produces  data  (such  as  a 
camera)  and  a  plug-in  that  consumes  data  (such  as  an  algorithm).  This  section 
concludes  with  a  discussion  of  the  development  process  of  a  plug-in  that  both 
consumes  and  produces  data.  This  in  combination  with  the  previously  defined 
OSUS  and  OSGi  terminology  will  provide  enough  information  to  allow  for  the 
efficient  and  effective  development  of  a  typical  OSUS  plug-in. 
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3.1  simpleFakeTripwire 


The  simpleFakeTripwire  asset  plug-in  randomly  generates  detections  for  testing 
and  example  purposes.  This  section  will  analyze  and  discuss  each  of  the  java  files 
associated  with  the  simpleFakeTripwire  asset,  with  emphasis  on  the  previously 
defined  OSUS  specific  components. 

3.1.1  simpleFakeTripwireAsset.java 

The  simpleFakeTripwire  is  an  asset  and  therefore  used  the  asset  template  from  the 
OSUS  SDK.  This  template  implements  the  AssetProxy  interface,  and  provides 
some  as  set- specific  functionality  through  the  Assetcontext  class  reference.  The 
SOverride  annotation  is  marked  above  many  methods  in  this  file,  but  the  needed 
annotations  (such  as  SActivate,  SModified,  and  @Deactivate)  are  encapsulated 
in  the  implemented  interface.  This  guide  will  point  out  these  overridden  annotations 
where  necessary.  The  annotation  and  class  declaration  are  as  follows: 

@Component (factory  =  Asset . FACTORY) 

public  class  simpleFakeTripwireAsset  implements  AssetProxy  { 

The  @Component  annotation  marks  the  class  as  a  component  and  assigns  its  factory 
as  the  Asset  .factory.  This  specific  factory  assignment  allows  the  OSUS 
controller  to  get  lists  of  assets,  based  on  their  presence  in  this  specific  Factory;  if 
creating  an  asset  plug-in,  this  factory  assignment  must  be  present  or  the  OSUS 
controller  will  not  recognize  the  asset.  Furthermore,  this  allows  for  the  instantiation 
of  multiple  assets.  To  use  the  OSUS  functionality  properly,  an  asset  must 
implement  the  AssetProxy  interface. 

//  property  variables 

int  interval; 

int  statuslnterval; 

SensingModalityEnum  modality; 

//  class  variable  for  housing  data  generator 
DataGenerator  dg  =  null; 

I  -k  -k 

*  Class  constructor. 

*/ 

public  simpleFakeTripwireAsset ()  { 

//  super  in  this  case  calls  java's  object  class  constructor, 

which 

does  nothing 

super () ; 

//  create  a  new  DataGenerator 
dg  =  new  DataGenerator () ; 

} 
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The  class-variable  declarations  and  class  constructor  are  shown  above.  Three 
variables  are  defined  for  configuration  management,  and  the  DataGenerator  is 
created  to  provide  the  example  plug-in  functionality. 


/  k  k 

*  Reference  to  the  context  which  provides  this  class  with 
methods  to 

*  interact  with  the  rest  of  the  system. 

*/ 

private  AssetContext  m_Context; 

j  k  k 

*  initialize  is  called  when  all  of  the  plug-in's 
dependencies  are  met, 

*  and  it  can  be  created 

*/ 

@Override 

public  void  initialize (final  AssetContext  context,  final 
Map<String, 

Object>  props)  throws  FactoryException  { 

//  set  the  provided  context  to  the  class  variable  for 
later  use 

m_Context  =  context; 

//  set  the  initial  properties  of  this  plug-in 
updated (props ) ; 

//  Set  the  plug-in's  status  message 
m_Context . setStatus (SummaryStatusEnum . OFF,  "Asset 
Inactive" ) ; 

} 

The  above  code  snippet  shows  the  creation  of  the  AssetContext  class  variable  and 
the  initialize  method.  The  initialize  method  is  the  method  corresponding  to  the 
@Activate  annotation  and  therefore  is  called  when  the  plug-in  is  being  created 
(bundle  activation).  When  the  OSGi  framework  calls  the  initialize  method,  it 
provides  a  reference  to  the  AssetContext  that  is  used  to  set  the  class  variable  and 
therefore  gain  access  to  the  OSUS-defined  AssetContext  methods. 


j  k  k 

*  updated  is  called  when  the  properties  of  the  plug-in  are 
changed  and 

*  need  updated 
*/ 

SOverride 

public  void  updated (final  Map<String,  Object>  props)  { 

//  create  a  configurable  from  the  input  properties.  This 
is  used  to 

set  the  user  defined  or  modified  properties  to  class 
variables 

final  simpleFakeTripwireAssetAttributes  config  = 
Configurable . createConf igurable ( 
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simpleFakeTripwireAssetAttributes . class ,  props) ; 


//set  the  class  variables  to  the  input  properties 
interval  =  config. interval () ; 
statuslnterval  =  config. statuslnterval () ; 
modality  =  config. modality () ; 

//  restart  the  data  generation  functionality 
dg . startOrStopTimer () ; 

} 

The  updated  method,  corresponding  to  the  @Modified  annotation,  controls  what 
is  done  when  the  plug-in  configuration  changes.  Specifically,  a  Configurable 
object  is  created  from  the  attributes  defined  in  the  corresponding  asset-attribute  file 
(simpleFakeTripwireAssetAttributes . java)  and  is  used  to  set  the  class 
variables  accordingly.  Following  the  class-variable  assignment,  the  data-generation 
functionality  is  started  (out  of  scope  of  this  report  and  will  not  be  discussed).  The 
asset-attribute  file  will  be  discussed  in  more  detail  later. 

/  ** 

*  onActivate  is  called  when  the  plug-in  is  to  be  activated 
*/ 

SOverride 

public  void  onActivate ()  throws  AssetException  { 

//  When  the  asset  is  activated,  we  will  generate  a  random 
detection 

//  at  periodic  intervals 

//  (delay  is  specified  in  the  asset  configuration)  and  post 
it  to  the 

//  persistent  store. 

//  set  the  data  generator  to  active 
dg. active  =  true; 

//  Start  the  timer  that  will  generate  the  periodic  image, 
dg . startOrStopTimer () ; 

//  Log  an  activation  method 

Logging . log (LogService . LOG_INFO,  "Fake  Tripwire 

activated" ) ; 

//  this  will  also  generate/send  a  status  observation 
m_Context . setStatus (SummaryStatusEnum . GOOD,  "Asset 

Activated" ) ; 

} 

As  mentioned  in  the  plug-in  life-cycle  section,  asset  plug-ins  have  an  extra  startup 
step  (plug-in  activation).  This  extra  step  is  handled  in  the  above  method, 
onActivate.  When  the  asset  is  set  to  begin  generating  data,  the  onActivate 
method  is  called  and  the  data  generator  is  set  to  active,  the  functionality  is  started, 
and  some  messages  are  logged. 


f  k  k 
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*  onDeactivate  is  called  when  the  asset  is  deactivated,  and 
therefore 

*  must 
*/ 

SOverride 

public  void  onDeactivate ( )  throws  AssetException  { 

//  Log  a  deactivation  message 

Logging . log (LogService . LOG_INFO,  "Fake  Tripwire 

deactivated" ) ; 

//  Set  variable  to  stop  the  timer 

dg. active  =  false; 

//  Stop  the  timer. 

dg . startOrStopTimer ()  ; 

//  Set  the  asset  status  accordingly 

m_Context . setStatus (SummaryStatusEnum . OFF,  "Asset 

Deactivated" ) ; 

} 

The  onDeactivate  method  is  defined  in  the  AssetProxy  interface  and  controls  the 
asset  deactivation  (described  in  Table  2  as  putting  the  plug-in  in  a  pause  like  state 
-  plug-in  deactivation).  This  method  stops  the  data  generation  functionality,  and 
sets  the  status  of  the  asset  to  deactivated.  The  onDeactivate  method  is  different 
from  a  method  bearing  the  @Deactivate  annotation,  as  such  a  method  would 
uninstall  the  plug-in  from  the  controller  instead  of  simply  changing  the  status  of  the 
asset. 


/  ** 

*  onCaptureData  is  called  when  the  asset  is  to  capture  data. 

This 

*  method  will  call  the 

*  observation  creation/capturing  methods,  and  then  return  the 

new 

*  observation. 

*/ 

SOverride 

public  Observation  onCaptureData ( )  { 

//  Generate  and  return  a  single  observation.  (The  base  class 

will 

//  handle  posting  the  observation  to  the  persistent  store.) 
Observation  obs  =  dg . generateObservation (null) ; 

//  Log  a  message  accordingly 

Logging . log (LogService . LOG_INFO,  "Fake  Tripwire  data 
captured" ) ; 

//  Return  the  generated  observation 

return  obs; 

} 
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The  onCaptureData  method  is  shown  above,  and  defined  in  the  AssetProxy 
interface.  This  asset  specific  method  handles  the  data  capturing  functionality  of  the 
plug-in.  The  comments  in  the  above  code  snippet  give  a  good  description  of  the 
functionality. 


/  ** 

*  onPerformBit  performs  some  type  of  self  checking,  and  then 
returns  a 

*  status  with  respect  to  health  of  the  plug-in. 

*/ 

SOverride 

public  Status  onPerformBit ()  { 

//  onPerformBit  should  be  a  health  checking  measure, 
however  as  this 

//  plug-in  is  a  data  generator  there  is  nothing  to  check 
//  Log  an  appropriate  message 

Logging . log (LogService . LOG_INFO,  "Performing  Fake  Tripwire 

BIT") ; 

//  return  a  status  representing  the  results  of  the  self 

check 

return  new  Status (). withSummaryStatus (new 

OperatingStatus (Summary St at usEnum . GOOD ,  "BIT 

Passed" ) ) ; 

} 

Some  self-checking  functionality  is  needed  for  assets,  and  is  called  from  the 
onPerformBit  method.  Because  this  example  is  a  data  generator,  there  is  nothing 
to  check.  But  if  this  were  an  asset  such  as  a  camera,  functionality  would  need 
implemented  here  that  would  allow  the  asset  to  provide  a  report  of  its  state  of  health. 


SOverride 

public  Response  onExecuteCommand ( final  Command 

capabilityCommand)  throws 

CommandExecutionException  { 

//  No  commands  currently  supported. 

throw  new  CommandExecutionException ( "This  asset  does 

not  support 

any  commands . " ) ; 

} 


The  last  OSUS  specific  method  in  the  simpleFakeTripwire  Asset  is  the 
onExecuteCommand  method.  This  method  is  not  supported  in  this  example,  but 
exists  to  handle  commands  from  the  controller.  (For  more  information,  see  the 
OSUS  Plug-In  Guide.)  Although  this  plug-in  persists  observations,  the  specifics  of 
this  will  be  covered  in  the  edgeDetector  walkthrough. 
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3.1.2  simpleFakeTripwireAssetAttributes.java 

OSUS  defines  the  AssetAttributes  class  for  configuration  management. 
Extending  this  class  into  a  plug-in  makes  attribute  management  easy.  This  small 
class  determines  what  attributes  can  be  changed  while  the  plug-in  is  running  and 
also  abstracts  the  parsing  and  processing  requirement  of  getting  these  attributes  into 
the  plug-in. 

/  ** 

*  Interface  which  defines  the  configurable  properties  for  a 

*  simpleFakeTripwire . 

*/ 

@OCD (description  = 

Conf igurationConstants . PART IAL_OBJECT_CLASS_DEF INI T ION) 
public  interface  simpleFakeTripwireAssetAttributes  extends 

AssetAttributes  { 

/** 

*  Each  method  annotated  with  @AD  becomes  a  configuration 
property 

*  available 

*  to  the  plug-in.  The  return  type  of  each  method  is  the  type 
of  the 

*  configuration  property.  All  simple  types  are  supported  and 
other  types 

*  are  supported  if  they  can  be  converted  from  a  string  (e.g., 
class  with 

*  a  constructor  accepting  a  string  or  an  enum) .  Also,  the  type 
can  be  an 

*  array  or  a  collection  for  properties  with  multiple  values. 
*/ 

@AD (required  =  false,  deflt  =  "60000",  name  =  "Detection 

Interval " , 

description  =  "Detection  Generation  Interval 

(milliseconds) ") 

int  interval  ( ) ; 

@AD (required  =  false,  deflt  =  "300000",  name  =  "Status 

Interval " , 

description  =  "Status  Generation  Interval  (milliseconds)") 
int  statuslnterval  () ; 

@AD (required  =  false,  deflt  =  "PIR",  name  =  "Modality", 

description  = 

"Modaility  (from  SensingModalityEnum) " ) 

SensingModalityEnum  modalityO; 


} 

The  @ad  annotation  represents  an  Attribute  Definition,  and  a  variable  declared  as 
shown  above  will  be  accessible  to  the  plug-in  as  well  as  users  and  other  plug-ins. 
Referencing  back  to  the  updated  method  previously  discussed  in  the 
simpleFakeTripwireAsset.java  file,  every  variable  defined  in 
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simpleFakeTripwireAssetAttributes  is  made  accessible  through  a 
configurable. 

3.1.3  simpleFakeTripwire  Capabilities— 

com.acme.assets.simpleFakeTripwire.simpleFakeTripwireAsset.x 

ml 

The  following  capabilities  file  describes  the  data  produced  by  the  simple 
FakeTripwire  as  well  as  the  commands  it  supports.  This  file  must  be  names 
packageName.className.xml,  or  it  will  not  be  found  by  the  system.  As  shown  on 
the  next  block  of  script,  the  <ns2  :modalities  description="none" 
vaiue=" imager" / >  line  describes  the  asset  as  an  imager.  Some  range  and  field  of 
view  capabilities  are  then  specified,  followed  by  the  detection  capabilities.  This 
capability  file  concludes  with  a  list  of  OSUS  commands  that  the  plug-in  supports. 
The  best  way  to  see  all  of  the  possible  fields  and  values  that  can  exist  in  this  file  is 
by  looking  at  the  one  generated  by  the  OSUS  SDK  when  creating  a  new  project. 
The  newly  created  capabilities  file  will  contain  all  possible  fields  and  example 
values.  The  XSD  files  describing  these  files,  which  are  the  files  the  capabilities  are 
validated  against,  can  be  found  at  the  locations  specified  in  Section  2.5. 

<?xml  version="l . 0"  encoding="UTF-8 "  standalone="yes " ?> 

<ns2 : As set Capabilities  xmlns=" capability . core . th . dod.mil" 

xmlns : ns2=" capability . asset . core . th . dod.mil" 

xmlns : ns 3= "capability . link . ccom. core . th . dod.mil" 

xmlns : ns 4= "capability . transport . ccom. core . th . dod.mil" 

xmlns : ns 5= "capability . physical . ccom. core . th . dod.mil" 

manuf acturer="Acme  Corporation,  Tactical  Systems  Division" 

description="Generates  random  detections  of  various  types" 

productName="Acme  Fake  Tripwire "> 

<primary Image  encoding=" image/ jpeg">/ 9 j < /primary Image > 
<secondary Images  encoding= "image/ jpeg" >/ 9 j</ secondary Image s> 
<ns2 : modalities  description="none"  value=" Imager " /> 

<ns2 : minRange>0 . 0</ns2 : minRange> 

<ns2 :maxRange>20 . 0</ns2 :maxRange> 

<ns2 : nominalRange>20 . 0</ns2 : nominalRange> 

<ns2 :minFov>20 . 0</ns2 :minFov> 

<ns2 :maxFov>20 . 0</ns2 :maxFov> 

<ns2 : nominalFov>20 . 0</ns2 : nominalFov> 

<ns2 : detectionCapabilities  targetld="false" 

direct ionOf Travel=" false"  t r ackH i st or y=" false" 

targetFrequency=" false"  targetLOB=" false" 

t ar get Orient at ion=" false"  t ar get Range=" false"  targetSpeed=" false" 

targetLocation="false"> 

<ns2 : typesAvailable>Alarm</ ns2 : typesAvailable> 

<ns2 : typesAvailable>Test</ ns 2 : types Aval lable> 

<ns2 : classifications  value="Other "  /> 

</ns2 : detectionCapabilities> 

<ns2 : commandCapabilities  perf ormBIT="true"  captureData="true"> 
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<ns2 : supportedCommands>GetPositionCommand</ ns2 : supportedCommands> 

<ns2 : supportedCommands>GetVersionCommand</ ns2 : supportedCommands> 

<ns2 : supportedCommands>SetPositionCommand</ ns2 : supportedCommands> 
</ ns2 : commandCapabilities> 

</ns2 : AssetCapabilities> 


3.1.4  simpleFakeTripwireAssetScanner.java 

If  supported,  this  file  controls  how  the  plug-in  scans  for  connected  assets.  This  is 
out  of  the  scope  of  this  report.  For  more  information,  see  the  OSUS  Plug-in  Guide.4 

3.1.5  Summary  of  the  FakeTripwire  Asset 

The  FakeTripwire  Asset  was  developed  as  an  example  plug-in  with  mock 
functionality  to  show  the  typical  composition  of  an  OSUS  plug-in.  This  mock  asset 
demonstrates  basic  functionality  of  the  mandatory  OSUS  functions  with  emphasis 
on  initialize,  updated,  onActivate,  onDeactivate,  and  onCaptureData . 
The  initialize  method  is  executed  when  the  plug-in  dependencies  are  satisfied 
(bundle  activation),  whereas  the  onActivate  method  is  executed  when  the  asset  is 
activated  (plug-in  activation).  The  onDeactivate  method  is  executed  to  deactivate 
the  asset  into  a  pause-like  state  (plug-in  deactivation),  and  the  updated  method 
controls  how  configuration  (attribute)  changes  are  handled.  The  onCaptureData  is 
executed  when  the  plug-in  is  signaled  to  collect  or  generate  data,  and  lastly, 
modifying  the  plug-in  attributes  during  runtime  is  made  easy  with  the 
AssetAttributes  class  and  a  configurable  object. 

3.2  SampleConsumer 

The  sampleConsumer  plug-in  was  created  as  an  example  of  how  to  gather 
observations  from  the  observation  store.  The  nontrivial  point  in  this  class  is  how 
the  observations  must  be  gathered,  because  if  not  done  on  a  separate  thread  the 
operation  times  out.  Not  all  of  the  previously  mentioned  OSUS-specific  points  in 
the  FakeTripwire  walkthrough  will  be  repeated,  but  all  new  material  will  be 
discussed. 

3.2.1  Consumer.java 

The  Consumer  as  stated  above  was  created  to  gather  observations  from  the 
observation  store.  This  functionality  is  not  as  abstracted  as  persisting  an  observation 
(such  as  in  FakeTripwire),  and  therefore  more  must  be  set  up  manually. 

SComponent ( 
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//  provides  EventHandler  service  to  receive  OSGi  events 
provide={EventHandler . class } , 

//  activate  always  even  if  no  consumers 
immediate=true, 

//  class  containing  config  info  for  the  metatype  and  config 

admin 

//  services 

designate=ConsumerConf iglnterface . class, 

//  activate  bundle  even  if  configuration  does  not  exist 
conf igurationPolicy=Conf igurationPolicy . optional , 

//  register  for  events  on  this  topic 
properties={EventConstants . EVENT_TOPIC  +  "="  + 

ObservationStore . TOPIC_OBSERVATION_PERSISTED 
+  +  ObservationStore . TOP IC_OBSERVATION_MERGED, 

}  ) 

public  class  Consumer  implements  EventHandler  { 

To  properly  prepare  a  class  to  observe  system  events  (such  as  when  another 
plug-in  persists  an  observation),  the  @Component  annotation  must  be  handled  a  little 
differently  than  what  was  seen  for  an  asset  (FakeTripwire).  The 
provide={ EventHandler .  class }  argument  provides  the  Event  Handler  service  to 
allow  for  the  reception  of  events.  The  immediate=true  parameter  is  needed, 
because  OSGi  only  creates  plug-ins  that  something  else  depends  on.  Often  with 
plug-ins  of  this  nature,  nothing  will  depend  on  it  and  therefore  nothing  will  be 
created;  however,  the  immediate  argument  will  ensure  the  plug-in  is  initialized, 
even  if  there  are  no  consumers  of  its  service.  The  configuration  parameter  sets  the 
presence  of  a  configuration  optional.  The  last  parameter,  properties ,  registers  the 
plug-in  to  receive  events  on  a  specific  topic.  This  functionality  can  be  used  as  a 
filter  in  the  case  there  is  only  a  specific  event  topic  under  concern.  The 
EventHandler  is  then  implemented,  as  this  is  the  main  interface  for  receiving 
events. 

Boolean  m_run  =  false; 

//  queue  holding  UUIDs  to  be  processed  by  the  logger  thread 

BlockingQueue<UUID>  m_eventQueue  =  new 

LinkedBlockingQueue<UUID>  ( )  ; 

EventProcThread  m_eventprocessor  =  null; 

ObservationStore  m_obsStore  =  null; 

Several  class  variables  are  defined  to  later  assist  with  keeping  track  of  things  such 
as  if  the  consumer  is  active  and  if  there  are  a  separate  thread  for  processing  events, 
a  queue  to  keep  track  of  the  events,  and  a  reference  to  the  observation  store. 


@Ref erence 

//  get  reference  to  the  ObservationStore  service  so  we  can 
retrieve 

//  observations  after  they  are  posted 

//  This  method  is  called  by  the  framework  due  to  the  @Reference 
//  annotation. 
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public  void  setObservationStore (ObservationStore  obsStore) 

{ 

m_obsStore  =  obsStore; 

} 

The  @Ref erence  annotation  represents  a  dependency.  This  dependency  calls  for  a 
reference  to  the  observation  store  using  the  external  setObservationStore 
method.  Furthermore,  the  OSGi  runtime  calls  this  method  during  initialization  and 
passes  it  the  reference  to  the  observation  store  that  exists  elsewhere  in  the  system. 
If  this  reference  cannot  be  satisfied  (e.g.,  an  observation  store  does  not  exist),  the 
plug-in  will  not  be  created. 

SActivate  //  <-  tells  bnd  this  is  the  activate  method 
//  activate  method  called  by  the  framework  when  all  dependences 
have  been 

//  satisfied  and  the  bundle  should  start  processing 
public  void  activate (Map<String,  Object>  properties) 

{ 

updateConfig (properties ) ; 
init  () ; 

} 

FakeTripwire  implemented  the  AssetProxy,  which  abstracted  the  OSGi 
annotations.  This  plug-in  does  not  have  that  convenience  and  therefore  the 
SActivate,  SModified,  and  @Deactivate  annotations  must  be  handled  manually. 
The  activate  method  here  is  equivalent  to  the  the  initialize  method  in  the 
AssetProxy  and  is  called  during  bundle  activation. 

@Deactivate  //  <-  tells  bnd  this  is  the  deactivate  method 
//  deactivate  method  called  by  the  framework  when  the  bundle 
should  be 

//  shut  down 

//  because  the  framework  is  stopping/the  bundle  is  being 
uninstalled/ etc. 

public  void  deactivate () 

{ 

stop  ()  ; 

} 

The  @Deactivate  annotation  is  described  in  the  above  comments.  This  method  is 
not  the  same  as  the  onDeactivate  method  of  FakeTripwire,  as  that  method  is  for 
plug-in  deactivation.  The  @Deactivate  method  represents  when  the  plug-in  itself 
is  being  stopped  or  uninstalled  (bundle  deactivation). 


@Modif ied 

public  void  modified (Map<String,  Object>  properties) 

{ 

updateConfig (properties ) ; 

} 
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Similar  to  the  Updated  method  described  in  the  FakeTripwire,  the  modified 
method  controls  how  the  configuration  of  the  bundle  is  managed.  In  this  case,  it 
simply  calls  another  method  to  handle  the  functionality  (which  will  be  discussed 
later).  The  @Modif  ied  annotation  tells  bndtools  this  is  the  method  to  call  when  the 
bundle  configuration  needs  updated.  In  the  case  of  FakeTripwire,  the  AssetProxy 
abstracts  the  gModified  annotation. 

void  stop() 

{ 

if  (m_eventprocessor  !=  null) 

{ 

m_eventprocessor . kill  =  true; 
m_eventprocessor . interrupt () ; 

try  { 

m_eventprocessor . join ()  ; 

}  catch  (InterruptedException  e)  { 
e  . printStackTrace ()  ; 

} 

m_eventprocessor  =  null; 

} 

Logging . log (LogService . LOG_INFO,  " Samp leCon sumer : 

STOPPED!  !  "  ) ; 

} 

The  stop  method  was  user  implemented  to  perform  the  actions  necessary  when  the 
plug-in  is  deactivated. 

void  updateConf ig (Map<String,  Object>  properties) 

{ 

ConsumerConf iglnterf ace  consumerconf ig  = 

Configurable . createConf igurable (ConsumerConf iglnterf ace .class , 
properties) ; 

m_run  =  consumerconf ig . Run () ; 

} 

The  updateConfig  method  was  called  from  the  method  bearing  the  gModified 
annotation.  This  method  controls  how  the  bundle  properties  will  be  updated  through 
use  of  a  configurable  just  like  FakeTripwire. 

gOverride 

public  void  handleEvent (Event  event)  { 

if  ( !m_run) 

{ 

Logging . log (LogService . LOG_INFO, " SampleConsumer : : 

handleEvent ..  .NOT  RUNNING  ....  IGNORING  EVENT."); 

return; 

} 


Approved  for  public  release;  distribution  is  unlimited. 


19 


try 

{ 

//  Check  event  topic  to  make  sure  it  is  something  we 

are 

interested  in. 

if  (event . getTopic (). compareTo ( 

ObservationStore . TOPIC_OBSERVATION_PERSISTED)  == 

0  I  I 

event . getTopic ( ) . compareTo ( 

ObservationStore . TOPIC_OBSERVATION_MERGED)  ==  0) 

{ 

//  We  are  interested  in  this  event.  However,  we  use 
a 

//  background  thread  to  do  the  actual 
//  processing,  because  handleEvent  ( )  is  called  on 

a  framework 

//  thread  and  we  need  to  return 

//  as  soon  as  possible.  If  handleEvent ( )  takes  too 

long,  it 

//  can  cause  the  framework  to  time  out 
//  and  stop  sending  events  to  this  bundle. 

//  Get  the  UUID  for  the  observation  that  was  just 

posted . 

UUID  obsUUID  =  (UUID) event . getProperty ( 
ObservationStore . EVENT_PROP_OBSERVATION_UUID) ; 
Logging . log (LogService . LOG_INFO, "SampleConsumer : 

got  event 

UUID:  "+  obsUUID. toString () ) ; 

//  Put  the  UUID  in  the  queue  for  processing  by  the 

background 

//  thread. 

m_eventQueue . offer (obsUUID)  ; 

} 

else 

{ 

//  sanity  check 

Logging . log (LogService . LOG_INFO, "SampleConsumer  :  : handleEvent : 

unexpected  event  topic  %s",  event . getTopic ()) ; 

return; 

} 

} 

catch  (Exception  e) 

{ 


Logging . log (LogService . LOG_INFO, 

got  exception 


} 


} 


"SampleConsumer: : handleEvent : 
%s",  e . getMessage () ) ; 


The  handleEvent  method  is  overridden  from  the  EventHandler  interface.  In  this 
case,  the  handleEvent  method  will  ensure  a  received  event  is  of  a  topic  that  the 
consumer  is  associated  with,  then  logs  the  received  event  and  adds  the  universally 
unique  identifier  (UUID)  of  the  event  to  the  m_eventQueue  for  later  use.  It  is 
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important  that  no  time-consuming  processing  be  performed  in  the  handieEvent 
method  or  the  operation  will  time  out  and  be  blacklisted.  Once  blacklisted,  the 
handieEvent  method  will  no  longer  be  called.  Therefore,  it  is  best  to  do  all 
processing  on  another  thread. 

void  init ( ) 

{ 

if  ( ! m_run) 

{ 

Logging . log (LogService . LOG_INFO,  " Samp leCon sumer : 

disabled  by 

configuration") ; 

return; 

} 

//  Start  processing  thread 

m_eventprocessor  =  new  EventProcThread () ; 
m_eventprocessor . setName ( "EventProcessor " )  ; 
m_eventprocessor . setDaemon (true) ; 
m_eventprocessor . start ()  ; 

} 

The  init  method  was  called  from  the  activate  method  seen  earlier.  Here  we  see 
the  consumer  is  initialized  by  starting  a  new  event-processing  thread  through  the 
EventProcThread  method.  This  is  important  because  if  an  operation  takes  too  long 
without  being  on  a  dedicated  thread,  the  operation  will  time  out  as  mentioned 
previously.  The  EventProcThread  class  is  shown  below. 

//  Background  thread  for  logging  the  data 
class  EventProcThread  extends  Thread 
{ 

public  boolean  kill  =  false; 

SOverride 
public  void  run() 

{ 

Logging . log (LogService . LOG_INFO, " SampleCon sumer  :  : EventProcThread : 
running" ) ; 

while  (!kill) 

{ 

Observation  obs  =  null; 
try 
{ 

//  Wait  for  an  observation  uuid  from 

handieEvent  ()  . 

UUID  obsUUID  =  m_eventQueue . take ( )  ; 

//  Retrieve  the  observation  from  the  persistent 

store . 

obs  =  m_obsStore . find (obsUUID) ; 
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Logging . log (LogService . LOG_INFO, "SampleConsumer : : 

EventProcThread :  got  Observation  from 
+obs . getAssetName () ) ; 

} 

catch  (InterruptedException  x) 

{ 

continue; 

} 

catch  (Exception  x) 

{ 


Logging . log (LogService . LOG_INFO, "SampleConsumer :  error 

processing  outbound  message: 

x . getMessage  ( ) ) ; 

continue; 

} 

} 


o.  o  ” 

O  O  f 


Logging . log (LogService . LOG_INFO, 

STOPPING! ! " ) ; 


} 


} 


"SampleConsumer : : EventProcThread : 


The  final  method  in  this  file  is  EventProcThread  that  extends  the  built-in  Java 
Thread.  This  implementation  simply  gets  observations  and  logs  a  message  stating 
the  observation  was  received.  Because  there  is  no  real  functionality  implemented 
here,  this  continues  until  a  kill  signal  is  received. 

3.2.2  ConsumerConfiglnterface.java 

The  configuration  interface  of  the  Consumer  is  very  similar  to  that  of  the 
FakeTripwire.  The  ConsumerConfiglnterface.java  file  creates  an  interface  as 
described  in  the  FakeTripwireAs  set  Attributes,  java  file. 

//  tells  BND  this  interface  provides  Conf igurationAdmin  data 
@OCD (name  =  "Consumer  plug-in")  public  interface 

ConsumerConf iglnterf ace  { 

//  tells  BND  this  is  a  configuration  attribute  definition,  and 
provides  a 

//  default  value 

SAD (required=false,  deflt  =  "true") 
boolean  Run ( ) ; 

} 


3.2.3  Summary  of  the  SampleConsumer 

The  SampleConsumer  was  developed  as  an  example  plug-in  to  show  how  an  OSUS 
plug-in  could  gather  observations  from  the  observation  store.  Although  there  was 
not  real  functionality  on  the  observations  after  they  were  gathered,  this  plug-in 
demonstrated  all  of  the  necessary  components  to  get  data  from  the  system.  More 
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annotations  were  seen  such  as  the  @Modified,  @Activate,  and  @Deactivate, 

which  show  how  bndtools  is  able  to  construct  the  life  cycle,  attributes,  and  services 
in  more  detail;  as  in  the  FakeTripwire  asset,  the  methods  with  these  annotations 
were  abstracted  into  the  implemented  AssetProxy.  Lastly,  a  technique  for  handling 
time-consuming  processes  was  shown,  as  a  separate  thread  is  needed. 

3.3  Writing  a  Plug-In 

The  previous  methods  have  analyzed  the  functionality  of  2  existing  OSUS  plug¬ 
ins:  one  that  consumes  data  and  one  that  provides  it.  This  section  will  reiterate  many 
of  the  topics  already  discussed,  yet  frame  them  in  a  way  that  coincides  more  with 
development  than  analysis.  By  the  end  of  this  section  (and  with  a  small  amount  of 
assistance  from  the  other  documents  where  mentioned),  all  of  the  tools  needed  to 
write  an  edge  detector  plug-in,  and  run  it  on  an  OSUS  controller,  will  have  been 
covered. 

3.3.1  Edge  Detector 

The  goal  of  this  example  is  to  implement  an  edge-detection  algorithm  in  OSUS. 
This  tutorial  will  use  concepts  from  both  of  the  previous  walkthroughs,  as  this  plug¬ 
in  must  not  only  consume  data  but  also  provide  it.  To  keep  on  the  simple  side,  this 
algorithm  implementation  will  simply  grab  any  image  persisted,  process  it,  and  then 
persist  (return)  the  edge  profile  of  the  image  as  a  new  observation  back  to  the 
observation  store.  To  test  this  edge  detector,  a  camera  to  capture  some  images  is 
needed.  The  testing- specific  setup  will  be  discussed  in  the  testing  section  at  the  end 
of  this  section.  The  full  source  code  can  be  seen  in  Appendixes  F,  G,  and  H. 

The  com.acme.sampleConsumer  will  be  used  as  a  starting  point,  so  that  project  will 
be  copied  to  a  new  location  and  renamed  to  mil.arl.alg.edgeDetector.  Ensure  that 
when  renaming  this,  you  update  the  directory  structure  to  match  the  name.  To  make 
the  transition  quick,  it  is  easiest  to  do  2  find-and-replace  queries  in  both  of  the 
source  files:  1)  find  “com.acme.sampleConsumer”  and  replace  with 
“mil.arl.alg.edgeDetector”  and  2)  find  “Consumer”  and  replace  with 
“edgeDetector”.  Another  important  step  is  to  change  the  first  line  in  the  bnd.bnd 
file  (Private-Package:)  to  match  the  package  name  (e.g.,  Private-Package: 
mil.arl.alg.edgeDetector)  *. 

Remembering  the  goal  of  this  plug-in,  3  main  steps  must  be  accomplished:  1) 
receive  a  persisted  image,  2)  compute  the  edge  profile  of  the  received  image,  and 
3)  persist  the  edge  profile  of  the  image  to  the  observation  store  as  a  new  observation. 


*  If  the  starting  project  is  an  asset  plug-in,  there  will  be  a  capabilities. xml  file  that  must  have  its  name 
changed  (as  mentioned  earlier)  or  the  plug-in  will  not  function  properly. 
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The  first  part  of  this  is  very  simple.  Because  we  used  the  sampleConsumer  project 
as  a  starting  point,  all  of  the  functionality  to  receive  an  image  has  already  been 
implemented.  Therefore,  we  can  move  on  to  Step  2. 

In  order  to  get  the  edge  profile  of  an  image,  and  edge-detection  algorithm  must  be 
used.  This  implementation  uses  the  edge-detector  class  found  at 
http://www.tomgibara.com/computer-vision/cannv-edge-detector.  This  java  class 
was  nested  into  the  plug-in  for  simplicity.  Now  that  we  have  obtained  an  edge- 
detection  algorithm,  we  must  pass  the  image  received  from  the  object  store  to  the 
edge  detector.  It  is  very  important  that  all  of  this  be  done  on  a  thread  or  the  operation 
will  time  out  before  completion. 

The  following  code  snippet  shows  the  event  thread  that  performs  the  following: 

•  Takes  the  UUID  of  an  observation  from  the  event  queue 

•  If  the  observation  has  not  already  been  processed,  or  is  not  an  image  that 
this  plug-in  generated,  proceeds 

•  Gets  an  observation  from  the  observation  store  by  UUID 

•  Gets  the  digital  media  from  the  observation 

•  Passes  the  received  digital  media  (image)  to  the  edge  detector,  and  receives 
back  the  edge  profile  as  new  digital  media  (more  in-depth  information  on 
this  process  later) 

•  Creates  a  new  observation,  and  adds  the  edge-profile  digital  media  and  an 
image  metadata  object  to  it 

•  Populates  the  observation  with  the  necessary  information  for  persisting 
(specifics  on  what  is  needed  for  each  of  the  data  types  can  be  seen  in  the 
XSDs  listed  in  Section  2.4) 

•  Persists  the  new  observation  to  the  observation  store 

class  EventProcThread  extends  Thread  { 

public  boolean  kill  =  false; 

SOverride 

public  void  run()  { 


Logging . log (LogService . LOG_INFO, " edgeDetector : : EventProcThread: 
running" ) ; 

while  ( !kill)  { 

Observation  obs  =  null; 
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try  { 


handleEvent  ()  . 


store,  if 


updated ! 


//  Wait  for  an  observation  uuid  from 
UUID  obsUUID  =  m_eventQueue . take ( ) ; 

//  Retrieve  the  observation  from  the  persistent 
//  not  already  processed. 

//  This  configuration  is  very  poor,  will  be 
if  ( Iprocessed. contains (obsUUID) )  { 

obs  =  m_obsStore . find (obsUUID)  ; 


Logging . log (LogService . LOG_INFO, "edgeDetector : : 

EventProcThread :  got  Observation 

from 

"+obs . getAssetName () ) ; 

//  to  make  simple,  simply  process  this 

observation 

//  and  post  the  processed  image 
DigitalMedia  receivedlmg  = 

obs . get DigitalMedia ( )  ; 


if  (receivedlmg  ==  null)  { 


Logging . log (LogService . LOG_INFO, "edgeDetector 

: : EventProcThread : 


was  null " ) ; 


continue; 


Received  Image 


Logging . log (LogService . LOG_INFO, 

"edgeDetector : : EventProcThread : 

Processing 

Received  observation"); 
DigitalMedia  processedlmg 

detectEdges (receivedlmg) ; 


Logging . log (LogService . LOG_INFO, "edgeDetector 

:: EventProcThread :  Finished 

processing,  persisting  new 

observation" ) ; 
processed . add (obsUUID) ; 


//  prepare  observation  for  persisting 
Observation  obslmg  =  new 


Observation () . withDigitalMedia (processedlmg) 

. withlmageMetadata (new 


ImageMetadata ()  )  ; 

UUID  newuuid  =  UUID . randomUUID ( ) ; 
obslmg . setUuid (newuuid) ; 
processed . add (newuuid) ; 
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obslmg. setSystemlnTestMode (_terraHarvestController 

. getOperationMode () 
OperationMode . TEST_MODE) ; 
obslmg . setVersion (m_obsStore 

. getObservationVersion () ) ; 

obslmg . setSystemld (_terraHarvestCont roller . get Id ( ) )  ; 

//obslmg. setAssetUuid ( serviceuuid)  ; 
obslmg . setUuid (newuuid)  ; 
obslmg . setAssetUuid (myassetid)  ; 


obslmg . set As set Name ( "Algorithm : EdgeDetection" ) ; 

obslmg . setAssetType ( "Algorithm" ) ; 
obslmg . setSensorld (servicepid)  ; 
obslmg . se t Cr e at edTime stamp (System 
. currentTimeMillis () ) ; 

//  prepare  image  metadata 
ImageMetadata  imd  =  new  ImageMetadata ( ) ; 
imd. setResolution (new  PixelResolution ( 

0)); 


imd. setlmageCaptureReason (new 


ImageCaptureReason (ImageCaptureReasonEnum 

.OTHER,  null)); 

imd. setCaptureTime (new 

Long (System. currentTimeMillis () ) )  ; 
imd. setPictureType (PictureTypeEnum 
. FULL_FIELD_OF_VIEW) ; 
imd. setFocus (1 . OF)  ; 
imd. set Zoom (1 . OF) ; 
imd. setColor (true) ; 


imd. setWhiteBalance (WhiteBalanceEnum . AUTO) ; 

imd. setChangedPixels (0.0); 
imd. setlmager (new  Camera (0,  "Alger", 
CameraTypeEnum. VISIBLE) )  ; 


//try  { 

obslmg . setlmageMetadata (imd) ; 
m_obsStore .persist (obslmg) ; 

/ /m_Context . persistObservation (obslmg) ; 
//}  catch  ( IllegalArgumentException  | 
PersistenceFailedException 
ValidationFailedException  e)  { 


/ /Logging . log (LogService . LOG_ERROR, "edgeDetector : 

error  persisting  image: 

e . getMessage ( ) ) ; 


//] 


} 


}  catch  (InterruptedException  x)  { 


continue; 


} 

catch  (Exception  x)  { 
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Logging . log (LogService . LOG_ERROR, "edgeDetector :  error 

processing  outbound  message:  %s", 

x . getMessage ( ) ) ; 

Logging . log (LogService . LOG_ERROR,  x, 

"edgeDetector :: EventProcThread :  %s", 

continue; 

} 

} 


Logging . log (LogService . LOG_INFO, "edgeDetector : : EventProcThread: 
STOPPING! ! " ) ; 

} 

} 

As  just  shown  in  the  code  snippet,  the  newly  created  object  is  persisted  using  the 
persist  method  of  the  object-store  reference.  (If  any  problems  are  encountered  or 
any  questions  arise  about  the  expected  composition  of  an  observation,  see  the  XSDs 
referred  to  in  Section  2.4.)  For  a  better  example  of  how  to  work  with  digital  media, 
the  following  method  shows  how  the  detectEdges  method  converts  from  digital 
media,  to  a  buffered  image,  and  back: 

/  ** 

*  detectEdges  computes  the  edges  on  the  passed  in  image,  and 

then 

returns  the  edge  profile  of  the  image. 

*  Qparam  dm  -  the  image  to  process 

*  Qreturn  -  the  edge  profile  of  the  image 
*/ 

public  DigitalMedia  detectEdges (DigitalMedia  dm)  { 

Logging . log (LogService . LOG_INFO, "edgeDetector:  searching 

for 

observation  edges"); 

//  create  the  detector 

CannyEdgeDetector  detector  =  new  CannyEdgeDetector ( ) ; 

//  adjust  its  parameters  as  desired 
//  this  is  held  for  use  in  future  version 
detector . setLowThreshold (m_lowThresh) ; 
detector . setHighThreshold (m_highThresh) ; 

//  get  image  from  received  observation 
byte []  rawimage  =  dm . getValue ( ) ; 

InputStream  rawImageStream  =  new 

ByteArraylnputStream (rawimage) ; 

Buf feredlmage  image  =  null; 

//  create  buffered  image  from  received  image 

try  { 

image  =  ImagelO . read (rawImageStream) ; 

}  catch  (IOException  e) { 
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Logging . log (LogService . LOG_ERROR, " edgeDetector :  error 

processing 

input  image:  %s",  e . getMessage  ()) ; 

return  dm; 

} 

//apply  detector  to  received  image 
detector . setSourcelmage (image) ; 
detector . process () ; 

//  get  resulting  edge  image 

Buf feredlmage  edges  =  detector . getEdgesImage () ; 

//  do  some  converting,  image  is  ARGB,  but  need  RGB  for  jpg 
Buf feredlmage  img  =  new  Buf feredlmage (edges . getWidth () , 
edges . getHeight ( ) ,  Buf feredlmage . TYPE_INT_RGB) ; 
img . setRGB ( 0 ,  0,  edges . getWidth () ,  edges . getHeight ()  , 

edges . getRGB (0 ,  0,  edges . getWidth () , 

edges . getHeight  () ,  null,  0, 

edges . getWidth ()) ,  0,  edges . getWidth ())  ; 

//convert  image  to  byte  array  for  insertion  into  digital 
media  object 

ByteArrayOutputStream  baos  =  new  ByteArrayOutputStream () ; 
byte []  edgelmageBytes  =  null; 
try  { 

ImagelO . write (img,  "jpg",  baos); 
baos . flush ( ) ; 

edgelmageBytes  =  baos . toByteArray ( ) ; 
baos . close ( ) ; 

//  output  image  to  file  for  testing  purposes 
//  ImagelO . write ( img,  "jPP"r  new 

File  (" . \\ What Is Happening . jpg" ) )  ; 

}  catch  (IOException  e) { 

Logging . log (LogService . LOG_ERROR, "edgeDetector:  error 

converting 

edge  profile  image:  %s",  e . getMessage ()) ; 

return  dm; 


} 

DigitalMedia  dmEdge  =  new  DigitalMedia (edgelmageBytes , 
" image/ jpg" ) ; 

return  dmEdge ; 

} 

As  just  shown  in  this  code  snippet,  a  digital-image  object  holds  the  image  data  as  a 
byte  array  (usually  in  JPEG  format),  and  can  be  accessed  through  the  getvaiue 
method  of  the  digital-media  object.  The  byte  array  can  then  be  converted  to  a 
buffered  image  for  use  by  the  edge  detector.  Converting  the  buffered  image 
returned  from  the  edge  detector  back  to  a  byte  array  (for  insertion  into  a 
digital-media  object)  is  more  difficult,  as  the  chosen  edge  detector  returns  an 
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alpha-red-green-blue  (ARGB)  image  where  we  want  a  red-green-blue  (RGB) 
image.  After  some  converting,  however,  the  buffered  image  is  changed  to  JPEG 
format  and  then  written  to  a  byte  array.  Inserting  a  byte  array  into  a  digital-media 
object  is  as  simple  as  creating  a  new  digital-media  object  with  arguments  for  the 
image  byte  array  and  the  data  type. 

The  edge  detector  implemented  here  takes  2  parameters:  a  low  threshold  and  a  high 
threshold.  As  an  example  of  how  to  implement  configurable  parameters  (or 
attributes),  these  were  added  to  the  edgeDetectorConfiglnterface.  The 
edgeDetectorConfiglnterface.java  is  the  same  as  what  was  previously  seen  in  the 
FakeTripwire  and  sampleConsumer  asset  attributes,  yet  includes  2  extra  values  for 
the  threshold  parameters: 

package  mil . arl . alg . edgeDetector ; 

import  aQute . bnd . annotation . metatype . Meta . AD ; 
import  aQute . bnd . annotation . metatype . Meta . OCD ; 

//  tells  BND  this  interface  provides  Conf igurationAdmin  data 

@OCD (name  =  "edgeDetector  plug-in") 

public  interface  edgeDetectorConfiglnterface  { 

//  tells  BND  this  is  a  configuration  attribute  definition,  and 
provides  a 

//  default  value 

SAD (required=false,  deflt  =  "true") 
boolean  Run ( ) ; 

SAD (required=false,  deflt  =  "0.5") 
float  lowThreshold ( ) ; 

SAD (required=false,  deflt  =  "1") 
float  highThreshold ( ) ; 

} 

This  example  has  3  defined  attributes:  a  Boolean  called  Run,  a  float  called 
lowThreshold,  and  a  float  called  highThreshold.  To  reiterate,  the  configuration 
process  defining  these  attributes  makes  them  accessible  to  the  OSUS-SG  (the  GUI, 
as  well  as  the  OSUS  controller  and  other  plug-ins)  and  editable  by  a  user.  If  any  of 
these  attributes  are  edited,  then  the  edgeDetector  will  get  the  updated  changes 
through  the  method  annotated  with  the  SModified  tag.  In  the  case  of  the 
edgeDetector: 

SModified 

public  void  modified (Map<String,  Object>  properties)  { 

updateConfig (properties )  ; 
setServicePIDString (properties)  ; 


} 
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The  updateConf  ig  method  is  called  and  the  property  map  sent  to  it.  This  property 
list  is  completely  managed  by  OSUS  and  OSGi.  By  simply  defining  them  in  the 
Configlnterface  file,  they  are  accessible  as  seen  here. 

void  updateConf ig (Map<String,  Object>  properties)  { 
edgeDetectorConf iglnterf ace  consumerconf ig  = 

Configurable . createConf igurable (edgeDetectorConf iglnterf ace . class 

f 

properties) ; 

m_run  =  consumerconf ig . Run () ; 

m_lowThresh  =  consumerconf ig . lowThreshold () ; 

m_highThresh  =  consumerconf ig . highThreshold () ; 


} 

As  just  seen,  a  configurable  is  created  for  the  edgeDetectorConfiglnterface,  and 
each  of  the  defined  attributes  is  callable  from  the  created  configurable.  This  allows 
for  access  to  any  newly  set  attribute;  then,  they  are  simply  set  to  a  class  variable  for 
later  use.  This  makes  for  very  easy  attribute  modification,  management,  and 
creation.  All  of  the  “heavy  lifting”  is  done  behind  the  scenes.  At  this  point,  the  new 
plug-in  can  be  built  for  testing. 

3.3.2  Building  and  Testing  the  Plug-in 

This  section  will  discuss  adding  the  newly  created  edge  detector  plug-in  to  a 
controller.  Before  getting  into  the  compilation  and  testing  of  the  plug-ins,  a  camera 
will  be  needed  to  generate  some  images.  The  plug-in 
edu.udayton.udri. asset. webcam.uvc  supports  any  USB  video  class  (UVC)- 
compliant  webcam;  therefore,  any  UVC-compliant  webcam  can  be  used  for  this 
test. 

To  compile  a  plug-in,  see  Section  5.4  in  the  OSUS  Plug-in  Guide.4  Compile  the 
UVC  plug-in  and  add  the  generated  jar  file  to  the  “bundles”  folder  within  your 
controller.  Compile  the  edgeDetector  and  add  the  generated  jar  file  to  this  “bundles” 
folder  as  well.  Start  the  OSUS  Controller  as  described  in  Section  1.3  of  this  report. 
Start  the  OSUS-SG,  and  connect  it  to  the  controller  using  the  instructions  found  in 
Section  6.7.2  of  the  OSUS-R  Operator  Instructions.6 

Follow  the  instructions  found  in  Section  6.9.1  in  OSUS-R  Operator  Instructions6  to 
ensure  both  the  UVC  plug-in  and  the  edgeDetector  plug-in  are  installed  and  active 
on  your  controller.  Then,  follow  the  instructions  found  in  Section  6.10.2  of  those 
instructions6  to  add  the  camera  asset  to  the  controller.  Now,  activate  the  camera 
asset. 
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The  camera  is  now  active  and  ready  to  capture  data,  and  the  edgeDetector  is  ready 
to  process  observations.  Select  the  Capture  Data  button  as  described  in  Section 
6.10.5.7  of  the  operator  instructions6  and  then  go  to  the  observations  tab  as  described 
in  Section  6.10.6.  At  this  point  you  should  see  (at  least)  2  observations:  one  image 
from  the  camera  and  the  edge  profile  as  an  image  from  the  edge  detector.  For 
troubleshooting,  ensure  the  edgeDetector  code  is  correct  and  refresh  the 
OSUS-SG  webpage.  If  this  is  not  the  problem,  see  Sections  5.7,  5.8,  and  5.9  of  the 
plug-in  guide4  for  more  detail  on  troubleshooting  and  plug-in  testing. 

3.3.3  Summary  of  the  EdgeDetector  Plug-in 

This  plug-in  used  the  sampleConsumer  plug-in  as  a  starting  point.  Functionality 
was  added  that  allows  for  the  processing  of  received  images  and  then  the  persisting 
of  the  results  back  to  the  observation  store.  This  example  shows  the  proper  use  of 
the  @ activate,  @ modified,  and  ©deactivate  annotations  as  well  as  how  to  process 
information  without  blacklisting  the  plug-in  due  to  timely  computations.  Lastly, 
this  example  presented  how  to  persist  an  observation  to  the  observation  store  using 
a  reference  received  by  the  OSGi  runtime  during  initialization. 

4.  Summary  and  Conclusion 

OSUS  is  a  sophisticated  standard  that  decreases  development  time,  decreases  code 
complexity,  and  increases  component  interoperability.  Furthermore,  placing  OSUS 
within  the  main  embedded  PC  or  microcontroller  of  a  sensor  system  allows  the 
system  to  leverage  all  of  the  existing  OSUS  capabilities  as  well  as  take  advantage 
of  the  OSUS  bridges,  interfaces,  and  mission  programs  that  have  already  been 
developed. 

This  guide  provides  the  basics  of  OSUS  and  its  underlying  framework,  OSGi,  while 
referring  to  other  documentation  for  greater  detail.  (Appendix  I,  additionally,  has 
an  OSUS  plug-in  compliance  checklist.)  Moreover,  practical  application  of  these 
basic  principles  is  shown  through  the  analysis  of  2  existing  plug-ins  and  the 
simulated  development  of  a  third  plug-in.  Although  the  OSUS  learning  curve  can 
be  steep,  this  report  aims  to  make  familiarization  much  simpler  and  reduce  the  time 
needed  to  achieve  proficiency  in  plug-in  development. 


Approved  for  public  release;  distribution  is  unlimited. 


31 


5.  References 


1.  OSUS-open  standards  for  unattended  sensors.  Adelphi  (MD):  Army  Research 
Laboratory  (US);  2016  Sep  13  [accessed  2017  Dec  11].  https://github.com/ssg- 
udri/OSUS-R/releases/download/1 . 1 .0/OSUS  .Standard.  1 . 1 .0.pdf. 

2.  Fauth  D.  Getting  started  with  OSGi  declarative  services.  Vogella  Blog, 
[accessed  2017  Oct  12].  http://blog.vogella.com/2016/06/21/getting-started- 
with-osgi-declarative-services/. 

3.  OSGi  Alliance.  The  dynamic  module  system  for  java.  San  Ramon  (CA):  c2017 
[accessed  2017  Oct  12].  https://www.osgi.org/. 

4.  OSUS  plug-in  guide.  Adelphi  (MD):  Army  Research  Laboratory  (US);  2016 
Oct  28  [accessed  2017  Dec  11].  https://github.com/ssg-udri/OSUS- 
R/releases/download/1 . 1 .0/OSUS.Plug-in.Guide.  1 . 1 .0.pdf. 

5.  OSUS  mission  programming  guide.  Adelphi  (MD):  Army  Research  Laboratory 
(US);  2016  Sep  13  [accessed  2017  Dec  11].  https://github.com/ssg-udri/OSUS- 
R/releases/download/l.l.O/OSUS. Mission.Programming.Guide.LLO.pdf. 

6.  OSUS-R  operator  instructions.  Adelphi  (MD):  Army  Research  Laboratory 
(US);  2016  Sep  13  [accessed  2017  Dec  11].  https://github.com/ssg-udri/OSUS- 
R/releases/download/1 . 1 .0/OSUS-R.Operator.Instructions.  1 . 1 .0.pdf. 

7.  OSUS  remote  interface  specification.  Adelphi  (MD):  Army  Research 
Laboratory  (US);  2016  Sep  13  [accessed  2017  Dec  11].  https://github.com/ssg- 
udri/OSUS-R/releases/download/1 . 1 .0/OSUS. Remote. Interface. Specification. 
l.l.O.pdf. 

8.  Apache  Felix.  OSGi  framework  and  service  platform,  [accessed  2017  Oct  12]. 
http  ://felix.  apache.org . 

9.  Thangarajah  K.  Kishanthan’s  blog:  Using  annotations  with  osgi  declarative 
services,  [accessed  2017  Mar  29].  https://kishanthan.wordpress.com/ 
201 4/03/29/using-annotation- with-osgi-declarative-services/. 

10.  TechTarget  SearchNetworking.  Definition:  OSGi  (open  service  gateway 

initiative).  Newton  (MA):  c2000-2017  [accessed  2017  Mar  16]. 

http :  //searchnetworking .  techtarget .  com/definition/OS  Gi . 


Approved  for  public  release;  distribution  is  unlimited. 


32 


Appendix  A.  simpleFakeTripwireAsset.java 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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package  com. acme . assets . simpleFakeTripwire ; 


import 

import 

import 

import 

import 


java . util . Map ; 
java . util . Random; 
java . util . Set ; 
java . util . Timer; 
java . util . Timer Task; 


import  aQut 
import  aQut 
import  mil . 
import  mil. 
import  mil. 
import  mil . 
import  mil. 
import  mil . 
import  mil. 
import  mil. 
import  mil . 
import  mil. 
import  mil . 
import  mil. 
import 
mil . dod . th . 
import  mil. 
import  mil . 
import  mil. 
import  mil. 
import  mil . 
import  mil. 
import  mil . 
import  mil. 
import  mil. 


e  .  bnd .  annotation . component . Component ; 

e . bnd . annotation . metatype .Configurable ; 

dod . th . core . asset . Asset ; 

dod .th. core. asset. As set Context ; 

dod .th. core. asset. As set Except ion ; 

dod .th. core. asset. AssetProxy ; 

dod . th . core . asset . commands . Command; 

dod .th. core. asset. commands .Response ; 

dod . th . core . commands . CommandExecut ionException ; 

dod . th . core . types . FrequencyKhz ; 

dod . th . core . types . SensingModality ; 

dod . th . core . types . SensingModalityEnum; 

dod . th . core . types . detection . DetectionTypeEnum; 

dod . th . core . types . detection . TargetClassif icationType ; 

core . types . detection . TargetClassif icationTypeEnum; 

dod . th . core . types .status . OperatingStatus ; 

dod . th . core . types .status . Summary St at usEnum; 

dod . th . core . factory . Extension ; 

dod . th . core . factory . Fact oryExcept ion; 

dod .th.core.log. Logging; 

dod . th . core . observation . types . Detection ; 

dod . th . core . observation . types . Observation ; 

dod . th . core . observation . types .Status ; 

dod . th . core . observation . types . TargetClassif icat ion ; 


import  org . osgi . service . log . LogService ; 


/  k  k 

*  Fake  tripwire,  for  testing  and  training  purposes. 

* 

*  gauthor  jkovach,  jtyo 
*/ 

@Component (factory  =  Asset . FACTORY) 

public  class  simpleFakeTripwireAsset  implements  AssetProxy  { 


//  property  variables 
int  interval; 
int  statuslnterval ; 
SensingModalityEnum  modality; 


//  class  variable  for  housing  data  generator 
DataGenerator  dg  =  null; 


I  k  k 

*  Class  constructor. 

*  / 

public  simpleFakeTripwireAsset ()  { 
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//  super  in  this  case  calls  java's  object  class 
constructor,  which  does  nothing 

super () ; 

//  create  a  new  DataGenerator 
dg  =  new  DataGenerator  () ; 

} 

/  ** 

*  Reference  to  the  context  which  provides  this  class  with 
methods  to 

*  interact  with  the  rest  of  the  system. 

*/ 

private  AssetContext  m_Context; 

f  k  k 

*  initialize  is  called  when  all  of  the  plugin's  dependencies 
are  met,  and  it  can  be  created 

*/ 

SOverride 

public  void  initialize  ( final  AssetContext  context,  final 
Map<String,  Object>  props)  throws  FactoryException  { 

//  set  the  provided  context  to  the  class  variable  for 
later  use 

m_Context  =  context; 

//  set  the  initial  properties  of  this  plugin 
updated (props ) ; 

//  Set  the  plug-in's  status  message 
m_Context . setStatus (SummaryStatusEnum . OFF,  "Asset 
Inactive" ) ; 

} 

/  *★ 

*  updated  is  called  when  the  properties  of  the  plugin  are 
changed  and  need  updated 

*/ 

SOverride 

public  void  updated (final  Map<String,  Object>  props)  { 

//  create  a  configurable  from  the  input  properties.  This 
is  used  to  set  the  user  defined  or  modified  properties  to  class 
variables 

final  simpleFakeTripwireAssetAttributes  config  = 
Configurable . createConf igurable (simpleFakeTripwireAssetAttributes 
. class , 

props) ; 

//set  the  class  variables  to  the  input  properties 
interval  =  config. interval () ; 
statuslnterval  =  config . statuslnterval () ; 
modality  =  config. modality () ; 

//  restart  the  data  generation  functionality 
dg . startOrStopTimer ()  ; 

} 

/  k  k 
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*  onActivate  is  called  when  the  plugin  is  to  be  activated 
*/ 

SOverride 

public  void  onActivate ()  throws  AssetException  { 

//  When  the  asset  is  activated,  we  will  generate  a  random 
detection  at 

//  periodic  intervals 

//  (delay  is  specified  in  the  asset  configuration)  and 
post  it  to  the 

//  persistent  store. 

//  set  the  data  generator  to  active 
dg. active  =  true; 

//  Start  the  timer  that  will  generate  the  periodic  image, 
dg . startOrStopTimer () ; 

//  Log  an  activation  method 

Logging . log (LogService . LOG_INFO,  "Fake  Tripwire 
activated" ) ; 

//  this  will  also  generate/send  a  status  observation 
m_Context . setStatus (SummaryStatusEnum . GOOD,  "Asset 
Activated" ) ; 

} 

/  *  * 

*  onDeactivate  is  called  when  the  asset  is  deactivated,  and 
therefore  must 

*/ 

@Override 

public  void  onDeactivate ( )  throws  AssetException  { 

//  Log  a  deactivation  message 

Logging . log (LogService . LOG_INFO,  "Fake  Tripwire 
deactivated" ) ; 

//  Set  variable  to  stop  the  timer 
dg. active  =  false; 

//  Stop  the  timer, 
dg . startOrStopTimer ()  ; 

//  Set  the  asset  status  accordingly 
m_Context . setStatus (SummaryStatusEnum. OFF,  "Asset 
Deactivated" ) ; 

} 

/** 

*  onCaptureData  is  called  when  the  asset  is  to  capture  data. 
This  method  will  call  the 

*  observation  creation/capturing  methods,  and  then  return 
the  new  observation. 

*/ 

@Override 

public  Observation  onCaptureData ( )  { 

//  Generate  and  return  a  single  observation.  (The  base 
class  will  handle 

//  posting  the  observation 
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//  to  the  persistent  store.) 

Observation  obs  =  dg . generateObservation (null) ; 

//  Log  a  message  accordingly 

Logging . log (LogService . LOG_INFO,  "Fake  Tripwire  data 
captured" ) ; 

//  Return  the  generated  observation 

return  obs; 

} 

j  k  k 

*  onPerformBit  performs  some  type  of  self  checking,  and  then 
returns  a  status  with  respect  to 

*  the  health  of  the  plugin. 

*/ 

SOverride 

public  Status  onPerformBit ()  { 

//  onPerformBit  should  be  a  health  checking  measure, 
however  as  this  plugin  is  a  data  generator 
//  there  is  nothing  to  check 
//  Log  an  appropriate  message 

Logging . log (LogService . LOG_INFO,  "Performing  Fake 
Tripwire  BIT"); 

//  return  a  status  representing  the  results  of  the  self 

check 

return  new  Status (). withSummaryStatus (new 
OperatingStatus (SummaryStatusEnum. GOOD,  "BIT  Passed")); 

} 

j  k  k 
k 

*  / 

gOverride 

public  Response  onExecuteCommand (final  Command 
capabilityCommand)  throws  CommandExecutionException  { 

//  No  commands  currently  supported. 

throw  new  CommandExecutionException ( "This  asset  does  not 
support  any  commands."); 

} 

/  k  k 
k 

*/ 

gOverride 

public  Set<Extension<?>>  getExtensions ()  { 

//  Currently  not  implemented 

return  null; 

} 


j  k  k 

*  Class  to  handle  data  generation 

k 

*  This  class  handles  all  of  the  data  generation  of  the  plug¬ 
in  and  is  not  osus  specific. 
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*  This  class  is  out  of  scope  of  this  discussion  and  will  not 
be  discussed. 

*/ 

private  class  DataGenerator  { 

//  Background  task  that  periodically  generates  an  image 
and  posts  it  to 

//  the  store. 

Random  prng; 

public  boolean  active  =  false; 


Timer  theObservationTimer  =  null; 
Timer  theStatusTimer  =  null; 


"44444" 

"GGGGG" 


String [ ]  targetldList  =  {  "11111",  "22222", 

"55555",  "66666",  "77777",  "88888",  "99999" 
"BBBBB" ,  "CCCCC",  "DDDDD " ,  "EEEEE" , 
"HHHHH" ,  "IIIII",  "JJJJJ",  "KKKKK"  }; 


"33333", 

,  "AAAAA" 
"FFFFF " , 


public  DataGenerator  ( )  { 

prng  =  new  Random (); 

} 


protected  class  ObservationMaker  extends  TimerTask  { 
SOverride 

public  void  run()  { 

generateAndPostDetection (null)  ; 

} 

} 


protected  class  StatusMaker  extends  TimerTask  { 
SOverride 

public  void  run()  { 

generateAndPostStatus () ; 

} 

} 


protected  void  startOrStopTimer ()  { 

if  (theObservationTimer  !=  null)  { 
theObservationTimer .cancel ( ) ; 
theObservationTimer  =  null; 

} 

if  (theStatusTimer  !=  null)  { 
theStatusTimer . cancel () ; 
theStatusTimer  =  null; 


if  (active)  { 

if  (interval  >  0)  { 

theObservationTimer  =  new  Timer (true); 
theObservationTimer . schedule (new 
ObservationMaker () ,  System. currentTimeMillis ()  %  interval, 

interval) ; 

} 

if  (statuslnterval  >  0)  { 

theStatusTimer  =  new  Timer (true); 
theStatusTimer . schedule (new  StatusMaker ( ) , 
statuslnterval,  statuslnterva  i) ; 
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} 


} 


} 


protected  void  generateAndPostStatus ()  { 

try  { 

//  Generate  an  observation. 

Observation  o  =  generateStatus () ; 

//  Post  it  to  the  persistent  store. 

//  postObservation  is  a  base  class  method  that 
does  this  for  us. 

m_Context . persist Observation (o) ; 

Logging . log (LogService . LOG_INFO,  "fake  tripwire 
posted  a  status  message"); 

}  catch  (Exception  e)  { 

Logging . log (LogService . LOG_ERROR,  e,  "fake 
tripwire  %s  could  NOT  post  status!",  m_Context . getName ( ) ) ; 

} 

} 


{ 


protected  void  generateAndPostDetection (String  targetld) 

try  { 


//  Generate  an  observation. 

Observation  o  =  generateObservation (targetld) ; 


//  Post  it  to  the  persistent  store. 

//  postObservation  is  a  base  class  method  that 
does  this  for  us. 


%s  posted  a 


tripwire  %s 


} 


m_Context . persist Observation (o) ; 

Logging . log (LogService . LOG_INFO,  "fake  tripwire 
detection,  modality  =  %s", 

m_Context . getName () ,  modality); 

}  catch  (Exception  e)  { 

Logging . log (LogService . LOG_ERROR,  e,  "fake 
could  NOT  post  detection!  %s", 

m_Context . getName ( ) ) ; 


} 


protected  Observation  generateStatus ()  { 

Observation  obs  =  new  Observation () ; 

//  system  will  take  care  of  setting  the  location, 
asset  id,  etc  in 

//  the  observation 
//  after  we  return  it 

//  obs . setSensorld ( " 0 " ) ; 

//  Send  some  status  too,  while  we're  at  it 
Status  s  =  new  Status  (); 
s . setSummaryStatus (new 

OperatingStatus () . with Summary (Summary St at usEnum . GOOD) ) ; 
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s.setSensorFov(lO.O) ; 
obs . setStatus  (s) ; 


return  obs; 

} 

//  Generates  observation  data. 

protected  Observation  generateObservation (String 
targetld)  { 

Observation  obs  =  new  Observation () ; 

//  obs . setSensorld ( " 0 " )  ; 

obs . getModalities ( ) .add(new  SensingModality (modality, 


//  add  some  detection  data 
Detection  dd  =  new  Detection (); 
dd. setType (DetectionTypeEnum. ALARM) ; 
dd. getTargetClassif i cat ions () 

.add(new  TargetClassif ication () 

.withType (new 

TargetClassif icationType () . withValue (TargetClassif icationTypeEnum 

. values ( ) [prng . next Int (TargetClassif icationTypeEnum . values ( ) . leng 

■■■)]))); 


if  (targetld  !=  null)  { 

dd. setTargetld (targetld)  ; 

}  else  if  (modality  ==  SensingModalityEnum . RFID)  { 


dd . setTargetld (target I dList [prng . next Int (target I dList . length) ] )  ; 

}  else  if  (modality  ==  SensingModalityEnum. RADIATION) 


{ 


dd. setTargetFrequency (new 
FrequencyKhz ( ) . withValue (prng . nextDouble ( ) 

} 


*  1000) ) ; 


obs . setDetection (dd) ; 


return  obs; 

} 


} 


} 
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Appendix  B.  simpleFakeTripwireAssetAttributes.java 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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package  com. acme . assets . simpleFakeTripwire ; 


import  aQute . bnd . annotation . metatype . Meta . AD ; 
import  aQute . bnd . annotation . metatype . Meta . OCD ; 
import  mil . dod. th . core . Conf igurationConstants  ; 
import  mil . dod. th . core . asset . AssetAttributes ; 
import  mil . dod. th . core . types . SensingModalityEnum; 

/** 

*  Interface  which  defines  the  configurable  properties  for  a 
simpleFakeTripwire . 

*/ 

@OCD (description  = 

Conf igurationConstants . PART IAL_OBJECT_CLASS_DEF INI T ION) 
public  interface  simpleFakeTripwireAssetAttributes  extends 
AssetAttributes  { 

/  k  k 

*  Each  method  annotated  with  @AD  becomes  a  configuration 
property  available 

*  to  the  plug-in.  The  return  type  of  each  method  is  the  type 
of  the 

*  configuration  property.  All  simple  types  are  supported  and 
other  types 

*  are  supported  if  they  can  be  converted  from  a  string 
(e.g.,  class  with  a 

*  constructor  accepting  a  string  or  an  enum) .  Also,  the  type 
can  be  an 

*  array  or  a  collection  for  properties  with  multiple  values. 
*/ 

@AD (required  =  false,  deflt  =  "60000",  name  =  "Detection 
Interval",  description  =  "Detection  Generation  Interval 
(milliseconds) ") 

int  interval (); 

@AD (required  =  false,  deflt  =  "300000",  name  =  "Status 
Interval",  description  =  "Status  Generation  Interval 
(milliseconds) ") 

int  statuslnterval  () ; 

SAD (required  =  false,  deflt  =  "PIR",  name  =  "Modality", 
description  =  "Modaility  (from  SensingModalityEnum)") 
SensingModalityEnum  modality (); 


} 
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Appendix  C.  simpleFakeTripwire  capabilities-xml 
com.  acme,  assets.  simpleFakeTripwire.simpleFakeTripwireAss 

et.xml 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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<?xml  version="l . 0"  encoding="UTF-8 "  standalone="yes " ?> 

<ns2 : As set Capabilities  xmlns=" capability . core . th . dod.mil" 
xmlns : ns2=" capability . asset . core . th . dod.mil" 
xmlns : ns 3= "capability . link . ccom. core . th . dod .mil" 
xmlns : ns 4= "capability . transport . ccom. core . th . dod.mil" 
xmlns : ns 5= "capability . physical . ccom. core . th . dod.mil" 
manuf acturer="Acme  Corporation,  Tactical  Systems  Division" 
description="Generates  random  detections  of  various  types" 
productName="Acme  Fake  Tripwire "> 

<primarylmage  encoding="image/ jpeg">/ 9 j</primarylmage> 
<secondary Images  encoding= "image/ jpeg" >/ 9 j</ secondary Image s> 
<ns2 : modalities  description="none"  value=" Imager " /> 

<ns2 :minRange>0 . 0</ns2 :minRange> 

<ns2 :maxRange>20 . 0</ns2 :maxRange> 

<ns2 : nominalRange>20 . 0</ns2 : nominalRange> 

<ns2 :minFov>20 . 0</ns2 :minFov> 

<ns2 :maxFov>20 . 0</ns2 :maxFov> 

<ns2 : nominalFov>20 . 0</ns2 : nominalFov> 

<ns2 : detectionCapabilities  targetld="false" 
direct ionOf Travel=" false"  t r ackH i st or y=" false" 
targetFrequency=" false"  t ar get LOB=" false" 

t arget Orient at ion=" false"  targetRange=" false"  targetSpeed=" false" 
targetLocation=" false "> 

<ns2 : typesAvailable>Alarm</ ns2 : typesAvailable> 

<ns2 : typesAvailable>Test</ ns 2 : types Aval lable> 

<ns2 : classifications  value="Other "  /> 

</ns2 : detectionCapabilities> 

<ns2 : commandCapabilities  perf ormBIT="true" 
captureData="true"> 

<ns2 : supportedCommands>GetPositionCommand</ ns2 : supportedCommands> 

<ns2 : supportedCommands>GetVersionCommand</ ns2 : supportedCommands> 

<ns2 : supportedCommands>SetPositionCommand</ ns2 : supportedCommands> 
</ ns2 : commandCapabilities> 

</ns2 : AssetCapabilities> 


*The  primarylmage  and  secondarylmages  lines  contain  the  base64  encoded  image. 
For  readability,  the  contents  of  those  tags  was  shortened  to  “/9j”. 
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Appendix  D.  simpleFakeTripwireAssetScanner.java 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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package  com. acme . assets . simpleFakeTripwire ; 


import  java . util . Has hMap; 
import  java . util . Set ; 

import  aQute . bnd . annotation . component . Component ; 
import  mil . dod . th . core. asset. Asset ; 

import  mil . dod. th . core . asset . AssetDirectoryService . ScanResults ; 
import  mil . dod. th . core . asset . AssetException; 
import  mil . dod .th. core. asset. As set Scanner ; 
import  mil . dod . th . core . factory . Product Type ; 

J  k  k 

*  TODO:  Optional  class.  Implement  the  scanForNewAssets  method  or 
remove  this 

*  class  if  scanning  is  not  supported. 

k 

*  Example  SDK  Plug-in  scanner  implementation. 

* 

*  Qauthor  jkovach 
*/ 

SComponent 

SProductType (simpleFakeTripwireAsset . class) 

public  class  simpleFakeTripwireAssetScanner  implements 

AssetScanner  { 

SOverride 

public  void  scanForNewAssets (final  ScanResults  results,  final 
Set<Asset>  existing)  throws  AssetException  { 
boolean  alreadyHave  =  false; 

for  (Asset  a  :  existing)  { 

if 

(a . getFactory () . getProductType () . equals (simpleFakeTripwireAsset . c 
lass . getName () ) )  { 

alreadyHave  =  true; 
break; 

} 

} 

if  (! alreadyHave)  { 

results . found ( " simpleFakeTripwirel " ,  new 
HashMap<String,  Object>()); 

} 

} 

} 
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Appendix  E.  Consumer.java 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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package  com . acme . sampleConsumer ; 


import  java . util . Map; 
import  java . util . UUID; 

import  java . util . concurrent . BlockingQueue ; 
import  java . util . concurrent . LinkedBlockingQueue ; 

import  mil . dod .th.core.log. Logging; 

import  mil . dod . th . core . observation . types . Observation ; 
import  mil . dod . th . core . persistence . Observat ionStore ; 

import  org . osgi . service . event . Event ; 
import  org . osgi . service . event . EventConstants ; 
import  org . osgi . service . event . EventHandler ; 
import  org . osgi . service . log . LogService ; 

import  aQute . bnd . annotation . component . * ; 

import  aQute . bnd . annotation . metatype .Configurable ; 

SComponent (provide={EventHandler . class }  ,  /*  provides  EventHandler 
service  to  receive  OSGi  events  */ 

immediate=true,  /*  activate  always  even  if  no  consumers  */ 
designate=ConsumerConf iglnterface . class,  /*  class  containing 
config  info  for  the  metatype  and  config  admin  services  */ 

conf igurationPolicy=Conf igurationPolicy . optional,  /*  activate 
bundle  even  if  configuration  does  not  exist  */ 

properties={EventConstants . EVENT_TOPIC  +  "="  + 
ObservationStore . TOPIC_OBSERVATION_PERSISTED 

+  +  ObservationStore . TOPIC_OBSERVATION_MERGED,  /* 

register  for  events  on  this  topic  */ 

}  ) 

public  class  Consumer  implements  EventHandler  { 

Boolean  m_run  =  false; 

//  queue  holding  UUIDs  to  be  processed  by  the  logger  thread 
BlockingQueue<UUID>  m_eventQueue  =  new 
LinkedBlockingQueue<UUID> ( ) ; 

EventProcThread  m_eventprocessor  =  null; 

ObservationStore  m_obsStore  =  null; 

@Ref erence 

//  get  reference  to  the  ObservationStore  service  so  we  can 
retrieve  observations  after 
//  they  are  posted 

//  This  method  is  called  by  the  framework  due  to  the 
SReference  annotation. 

public  void  setObservationStore (ObservationStore  obsStore) 

{ 

m_obsStore  =  obsStore; 

} 

@Activate  //  <-  tells  bnd  this  is  the  activate  method 
//  activate  method  called  by  the  framework  when  all 
dependences  have  been  satisfied  and 

//  the  bundle  should  start  processing 

public  void  activate (Map<String,  Object>  properties) 
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{ 

updateConfig (properties )  ; 
init  () ; 

} 

SDeactivate  //  <-  tells  bnd  this  is  the  deactivate  method 
//  deactivate  method  called  by  the  framework  when  the  bundle 
should  be  shut  down 

//  because  the  framework  is  stopping/the  bundle  is  being 
un in stalled/ etc . 

public  void  deactivate () 

{ 

stop  ()  ; 

} 

@Modif ied 

public  void  modified (Map<String,  Object>  properties) 

{ 

updateConfig (properties ) ; 

} 

void  stop() 

{ 

if  (m_eventprocessor  !=  null) 

{ 

m_eventprocessor . kill  =  true; 
m_eventprocessor . interrupt () ; 

try  { 

m_eventprocessor . join ()  ; 

}  catch  (InterruptedException  e)  { 
e  .  print St ackTr ace ( )  ; 

} 

m_eventprocessor  =  null; 

} 

Logging . log (LogService . LOG_INFO,  " Samp leCon sumer : 

STOPPED! ! " ) ; 

} 

void  updateConfig (Map<String,  Object>  properties) 

{ 

ConsumerConf iglnterf ace  consumerconf ig  = 

Configurable . createConf igurable (ConsumerConf iglnterf ace .class, pro 
perties) ; 

m_run  =  consumerconf ig . Run () ; 

} 

SOverride 

public  void  handleEvent (Event  event)  { 

if  ( ! m_run) 

{ 

Logging . log (LogService . LOG_INFO, " Samp leCon sumer : : handleEvent . . . NO 
T  RUNNING. . . . IGNORING  EVENT. ") ; 

return; 

} 

try 
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{ 


//  Check  event  topic  to  make  sure  it  is  something  we 
are  interested  in. 

if 

(event . get Topic ( ) . compareTo (ObservationStore . TOPIC_OBSERVATION_PE 
RSISTED)  ==  0 

I  I 

event . getTopic () . compareTo (ObservationStore . TOPIC_OBSERVATION_MER 

GED)  ==  0) 

{ 

//  We  are  interested  in  this  event.  However,  we 
use  a  background  thread  to  do  the  actual 

//  processing,  because  handleEvent ( )  is  called  on 
a  framework  thread  and  we  need  to  return 

//  as  soon  as  possible.  If  handleEvent ( )  takes 
too  long,  it  can  cause  the  framework  to  time  out 

//  and  stop  sending  events  to  this  bundle. 

//  Get  the  UUID  for  the  observation  that  was  just 

posted . 

UUID  obsUUID  = 

(UUID) event . getProperty (ObservationStore . EVENT_PROP_OBSERVATION_U 
UID)  ; 

Logging . log (LogService . LOG_INFO, " Samp leCon sumer : 
got  event  UUID:  "+  obsUUID . toString ()) ; 

//  Put  the  UUID  in  the  queue  for  processing  by 
the  background  thread. 

m_eventQueue . offer (obsUUID)  ; 

} 

else 

{ 

//  sanity  check 

Logging . log (LogService . LOG_INFO, "SampleConsumer : : handleEvent : 
unexpected  event  topic  %s",  event . getTopic ()) ; 

return; 

} 

} 

catch  (Exception  e) 

{ 

Logging . log (LogService . LOG_INFO, "SampleConsumer : : handleEvent :  got 
exception  %s",  e . getMessage () ) ; 

} 


} 

void  init ( ) 

{ 

if  ( ! m_run) 

{ 

Logging . log (LogService . LOG_INFO,  "SampleConsumer : 
disabled  by  configuration"); 

return; 

} 


//  Start  processing  thread 
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} 


m_eventprocessor  =  new  EventProcThread () ; 
m_eventprocessor . setName ( "EventProcessor" )  ; 
m_eventprocessor . setDaemon (true)  ; 
m_eventprocessor . start ()  ; 


//  Background  thread  for  logging  the  data 
class  EventProcThread  extends  Thread 
{ 

public  boolean  kill  =  false; 

SOverride 
public  void  run() 

{ 

Logging . log (LogService . LOG_INFO, " SampleCon sumer  :  : EventProcThread : 
running" ) ; 


while  ( ! kill ) 

{ 

Observation  obs  =  null; 
try 
{ 

//  Wait  for  an  observation  uuid  from 

handleEvent () . 

UUID  obsUUID  =  m_eventQueue . take ( ) ; 

//  Retrieve  the  observation  from  the 

persistent  store. 

obs  =  m_obsStore . find (obsUUID) ; 

Logging . log (LogService . LOG_INFO, "SampleConsumer : : EventProcThread : 
got  Observation  from  "+obs . getAssetName () ) ; 

} 

catch  (InterruptedException  x) 

{ 

continue; 

} 

catch  (Exception  x) 

{ 

Logging . log (LogService . LOG_INFO, "SampleConsumer :  error  processing 
outbound  message:  %s",  x . getMessage ( ) ) ; 

continue; 

} 

} 


Logging . log (LogService . LOG_INFO, "SampleConsumer : : EventProcThread : 
STOPPING! ! " ) ; 

} 

} 


} 
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Intentionally  lelt  blank. 


Approved  for  public  release;  distribution  is  unlimited. 


52 


Appendix  F.  ConsumerConfiglnterface.java 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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package  com . acme . sampleConsumer ; 


import  aQute . bnd . annotation . metatype . Meta . AD ; 
import  aQute . bnd . annotation . metatype . Meta . OCD ; 

@OCD (name  =  "Consumer  plug-in")  //  <-  tells  BND  this  interface 

provides  Conf igurationAdmin  data 

public  interface  ConsumerConf iglnterface  { 

@AD (required=false,  deflt  =  "true")  //  <-  tells  BND  this  is  a 
configuration  attribute  definition,  and  provides  a  default  value 
boolean  Run ( ) ; 

} 
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Appendix  G.  edgeDetector.java 


This  appendix  appears  in  its  original  form,  without  editorial  change. 


Approved  for  public  release;  distribution  is  unlimited. 


55 


package  mil . arl . alg . edgeDetector ; 


import  java . util . Map; 
import  java . util . UUID; 

import  java . util . concurrent . BlockingQueue ; 
import  java . util . concurrent . LinkedBlockingQueue ; 


import  mil . dod. th . core . controller . TerraHarvestController; 

import 

mil . dod . th . core . controller . TerraHarvestController . OperationMode ; 
import  mil . dod .th.core.log. Logging; 

import  mil . dod. th . core . observation . types . ImageMetadata; 
import  mil . dod. th . core . observation . types . Observation; 
import  mil . dod . th . core . persistence . Observations tore ; 
import  mil . dod . th . core . types . DigitalMedia; 
import  mil . dod . th . core . types . image . Camera ; 
import  mil . dod . th . core . types . image . CameraTypeEnum; 
import  mil . dod . th . core . types . image . ImageCaptureReason ; 
import  mil . dod . th . core . types . image . ImageCaptureReasonEnum; 
import  mil . dod . th . core . types . image . PictureTypeEnum; 
import  mil . dod. th . core . types . image . PixelResolution; 
import  mil . dod . th . core . types . image . WhiteBalanceEnum; 


import 

import 

import 

import 

import 


org . osgi . framework . BundleContext ; 
org . osgi . service . event . Event ; 
org . osgi . service . event . Event Const ants ; 
org . osgi . service . event . Event Handle r ; 
org . osgi . service . log . LogService ; 


import  aQute . bnd . annotation . component . * ; 

import  aQute . bnd . annotation . metatype .Configurable ; 

import  mil . arl . alg . edgeDetector . edgeDetectorConf iglnterface ; 


//  imports  for  the  edge  detection 

import  java . awt . image . Buf feredlmage ; 

import  java . util . ArrayList ; 

import  java . util . Arrays ; 

import  java . util . List ; 

import  java . io . InputStream; 

import  java . io . ByteArraylnputStream; 

import  java . io . ByteArrayOutputStream; 

import  java . io . File; 

import  java . io . IOException; 

import  javax . imageio . ImagelO; 


@Component (provide={EventHandler . class } ,  /*  provides  EventHandler 
service  to  receive  OSGi  events  */ 

immediate=true,  /*  activate  always  even  if  no  consumers  */ 
designate=edgeDetectorConf iglnterface . class ,  /*  class 
containing  config  info  for  the  metatype  and  config  admin  services 
*/ 

conf igurationPolicy=Conf igurationPolicy . optional,  /*  activate 
bundle  even  if  configuration  does  not  exist  */ 

//  this  property  filtering  should  be  okay,  as  the  photos 
posted  under  concerned  are  persisted 
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properties={EventConstants . EVENT_TOPIC  +  "="  + 
ObservationStore . TOPIC_OBSERVATION_PERSISTED 

+  +  ObservationStore . TOPIC_OBSERVATION_MERGED,  /* 

register  for  events  on  this  topic  */ 

}  ) 

public  class  edgeDetector  implements  EventHandler  { 

//Config  Variables 
Boolean  m_run  =  false; 

Float  m_lowThresh  =  null; 

Float  m_highThresh  =  null; 

//  queue  holding  UUIDs  to  be  processed  by  the  logger  thread 
BlockingQueue<UUID>  m_eventQueue  =  new 
LinkedBlockingQueue<UUID> ( ) ; 

EventProcThread  m_eventprocessor  =  null; 

List<UUID>  processed  =  new  ArrayList<UUID> ( ) ; 
TerraHarvestController  _terraHarvestController  =  null; 

String  servicepid  =  "unknown"; 

String  serviceuuidstring  =  "unknown"; 

UUID  serviceuuid; 

UUID  myassetid  =  UUID . randomUUID ( ) ;  //  This  will  probably 

need  set  at  some  point  -  17  Jan  2017 

ObservationStore  m_obsStore  =  null; 


//  get  reference  to  the  ObservationStore  service  so  we  can 
retrieve  observations  after 
//  they  are  posted 

//  This  method  is  called  by  the  framework  due  to  the 
@Reference  annotation. 

@Ref erence 

public  void  setObservationStore (ObservationStore  obsStore)  { 
m_obsStore  =  obsStore; 


} 


//  tells  bnd  this  is  the  activate  method 
//  activate  method  called  by  the  framework  when  all 
dependences  have  been  satisfied  and 

//  the  bundle  should  start  processing 
SActivate 

public  void  activate (Map<String,  Object>  properties)  { 

updateConfig (properties )  ; 
init  () ; 

setServicePIDString (properties) ; 


} 


//  tells  bnd  this  is  the  deactivate  method 

//  deactivate  method  called  by  the  framework  when  the  bundle 
should  be  shut  down 
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//  because  the  framework  is  stopping/the  bundle  is  being 
uninstalled/ etc. 

SDeactivate 

public  void  deactivate ()  { 

stop  ()  ; 


} 

//  get  reference  to  the  setEventAdmin  service  used  to  post 
events 

@Ref erence 

public  void  setTerraHarvestController (TerraHarvestController 
ths )  { 


terraHarvestController  =  ths; 


} 


@Modif ied 

public  void  modified (Map<String,  Object>  properties)  { 

updateConfig (properties )  ; 
setServicePIDString (properties)  ; 


} 


private  void  setServicePIDString (Map<String,  Object> 
properties)  { 

try  { 

String  temp  =  (  (String) 
properties . get ( " service . pid" ) )  ; 

serviceuuidstring  = 

temp  . substring (temp . lastlndexOf (".")+!) ; 

}  catch  (NullPointerException  e)  { 

Logging . log (LogService . LOG_INFO, "edgeDetector :  error 
setting  service  PID,  creating  random  UUID:  %s",  e . getMessage () ) ; 

serviceuuidstring  =  UUID . randomUUID ( )  . toString  () ; 


} 

serviceuuid  =  UUID . fromString (serviceuuidstring) ; 
servicepid  =  "edgeDetector."  +  serviceuuidstring; 


} 


void  stop()  { 

if  (m_eventprocessor  !=  null)  { 
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m_eventprocessor . kill  =  true; 
m_eventprocessor . interrupt ()  ; 

try  { 

m_eventprocessor . join ()  ; 

}  catch  (InterruptedException  e)  { 
e  . printStackTrace ()  ; 

} 

m_eventprocessor  =  null; 

} 

Logging . log (LogService . LOG_INFO,  "edgeDetector : 
STOPPED!  ! " )  ; 

} 


void  updateConf ig (Map<String,  Object>  properties)  { 

edgeDetectorConf iglnterf ace  consumerconf ig  = 

Configurable . createConf igurable (edgeDetectorConf iglnterf ace . class 
,  properties) ; 

m_run  =  consumerconf ig . Run () ; 

m_lowThresh  =  consumerconf ig . lowThreshold () ; 

m_highThresh  =  consumerconf ig . highThreshold () ; 


} 


SOverride 

public  void  handleEvent (Event  event)  { 

if  ( ! m_run)  { 


Logging . log (LogService . LOG_INFO, "edgeDetector : : handleEvent . . . NOT 
RUNNING. . . .IGNORING  EVENT. ") ; 

return; 


} 

try  { 

//  Check  event  topic  to  make  sure  it  is  something  we 
are  interested  in. 

if 

(event . get Topic ( ) . compareTo (ObservationStore . TOPIC_OBSERVATION_PE 
RSISTED)  ==  0 

I  I 

event . getTopic ( ) . compareTo (ObservationStore . TOPIC_OBSERVATION_MER 

GED)  ==  0)  { 

//  We  are  interested  in  this  event.  However,  we 
use  a  background  thread  to  do  the  actual 

//  processing,  because  handleEvent ( )  is  called  on 
a  framework  thread  and  we  need  to  return 
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//  as  soon  as  possible.  If  handleEvent ( )  takes 
too  long,  it  can  cause  the  framework  to  time  out 

//  and  stop  sending  events  to  this  bundle. 


posted . 


//  Get  the  UUID  for  the  observation  that  was  just 
UUID  obsUUID  = 


(UUID) event . getProperty (ObservationStore . EVENT_PROP_OBSERVATION_U 
UID)  ; 

Logging . log (LogService . LOG_INFO, "edgeDetector : 
got  event  UUID:  "+  obsUUID . toString ()) ; 

//  Put  the  UUID  in  the  queue  for  processing  by 
the  background  thread. 

m_eventQueue . offer (obsUUID)  ; 


}  else  { 


//  sanity  check 

Logging . log (LogService . LOG_INFO, "edgeDetector : : handleEvent : 
unexpected  event  topic  %s",  event . getTopic ()) ; 

return; 


} 

}  catch  (Exception  e)  { 


Logging . log (LogService . LOG_INFO, " edgeDetector : : handleEvent :  got 
exception  %s",  e . getMessage () ) ; 

} 

} 


void  init ( )  { 

Logging . log (LogService . LOG_INFO,  "edgeDetector : 
Initializing") ; 

if  ( ! m_run)  { 

Logging . log (LogService . LOG_INFO,  "edgeDetector : 
disabled  by  configuration"); 

return; 


} 

//  Start  processing  thread 

Logging . log (LogService . LOG_INFO,  "edgeDetector:  Start 
processing  thread"); 

m_eventprocessor  =  new  EventProcThread () ; 
m_eventprocessor . setName ( "EventProcessor " )  ; 
m_eventprocessor . setDaemon (true)  ; 
m_eventprocessor . start () ; 


} 
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//  Background  thread  for  logging  the  data 
class  EventProcThread  extends  Thread  { 

public  boolean  kill  =  false; 

SOverride 

public  void  run()  { 


Logging . log (LogService . LOG_INFO, "edgeDetector : : EventProcThread : 
running" ) ; 


while  ( !kill)  { 

Observation  obs  =  null; 
try  { 


handleEvent  ()  . 

persistent  store, 
updated ! 


//  Wait  for  an  observation  uuid  from 

UUID  obsUUID  =  m_eventQueue . take ( ) ; 

//  Retrieve  the  observation  from  the 
if  not  already  processed. 

//  This  configuration  is  very  poor,  will  be 

if  ( iprocessed. contains (obsUUID) )  { 

obs  =  m_obsStore . find (obsUUID)  ; 


Logging . log (LogService . LOG_INFO, "edgeDetector : : EventProcThread : 
got  Observation  from  "+obs . getAssetName () ) ; 

//  to  make  simple,  simply  process  this 
observation  and  post  the  processed  image 

DigitalMedia  receivedlmg  = 

obs . getDigitalMedia () ; 


if  (receivedlmg  ==  null)  { 

Logging . log (LogService . LOG_INFO, "edgeDetector : : EventProcThread : 
Received  Image  was  null"); 

continue; 

} 


Logging . log (LogService . LOG_INFO, "edgeDetector : : EventProcThread : 
Processing  received  observation") ; 

DigitalMedia  processedlmg  = 
detectEdges (receivedlmg) ; 

Logging . log (LogService . LOG_INFO, "edgeDetector : : EventProcThread : 
Finished  processing,  persisting  new  observation") ; 

processed . add (obsUUID) ; 

//  prepare  observation  for  persisting 
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Observation  obslmg  =  new 

Observation () . withDigitalMedia (processedlmg) . withlmageMetadata (ne 
w  ImageMetadata () )  ; 

UUID  newuuid  =  UUID . randomUUID ( ) ; 
obslmg . setUuid (newuuid) ; 
processed . add (newuuid) ; 

obslmg . setSystemlnTestMode (_terraHarvestController . getOperationMo 
de()  ==  OperationMode . TEST_MODE) ; 

obslmg . setVersion (m_obsStore . getObservationVersion () ) ; 


obslmg . setSystemld (_terraHarvestCont roller . get Id ( )  )  ; 

//obslmg. setAssetUuid ( serviceuuid)  ; 
obslmg . setAssetUuid (myassetid)  ; 

obslmg . setAssetName ( "Algorithm : EdgeDetection" )  ; 

obslmg . setAssetType ( "Algorithm" ) ; 
obslmg . setSensorld (servicepid) ; 


obslmg. setCreatedTimestamp (System. currentTimeMillis () ) ; 

//  prepare  image  metadata 
ImageMetadata  imd  =  new  ImageMetadata () ; 
imd . set Re solution (new  PixelRe solution ( 0 , 

0)); 


imd. setlmageCaptureReason (new 
ImageCaptureReason ( ImageCaptureReasonEnum . OTHER,  null)) ; 

imd. setCaptureTime (new 
Long (System. currentTimeMillis () )  )  ; 


imd. setPictureType (PictureTypeEnum . FULL_FIELD_OF_VIEW) ; 

imd. setFocus (1 . OF) ; 
imd. set Zoom (1 . OF) ; 
imd. setColor (true) ; 


imd. setWhiteBalance (WhiteBalanceEnum . AUTO) ; 

imd. setChangedPixels (0.0); 
imd. setlmager (new  Camera (0,  "Alger", 
CameraTypeEnum. VISIBLE)  )  ; 

//try  { 

obslmg . setlmageMetadata (imd)  ; 
m_obsStore .persist (obslmg) ; 

//m_Context . persistObservation (obslmg) ; 
//}  catch  ( IllegalArgumentException  | 
PersistenceFailedException  |  ValidationFailedException  e)  { 

/ /Logging . log (LogService . LOG_ERROR, "edgeDetector :  error 
persisting  image:  %s",  e . getMessage ( ) ) ; 

//} 

} 

}  catch  (InterruptedException  x)  { 

continue; 


} 

catch  (Exception  x)  { 
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Logging . log (LogService . LOG_ERROR, "edgeDetector :  error  processing 
outbound  message:  %s",  x . getMessage ( ) ) ; 

Logging . log (LogService . LOG_ERROR,  x, 
"edgeDetector :: EventProcThread :  %s", 

continue; 

} 

} 


Logging . log (LogService . LOG_INFO, "edgeDetector : : EventProcThread: 
STOPPING! ! ") ; 

} 

} 

/  k  k 

*  detectEdges  computes  the  edges  on  the  passed  in  image,  and 
then  returns  the  edge  profile  of  the  image. 

k 

*  Qparam  dm  -  the  image  to  process 

*  @return  -  the  edge  profile  of  the  image 
*/ 

public  DigitalMedia  detectEdges (DigitalMedia  dm)  { 

Logging . log (LogService . LOG_INFO, "edgeDetector:  searching 
for  observation  edges"); 

//  create  the  detector 

CannyEdgeDetector  detector  =  new  CannyEdgeDetector () ; 

//  adjust  its  parameters  as  desired 
//  this  is  held  for  use  in  future  version 
detector . setLowThreshold (m_lowThresh) ; 
detector . setHighThreshold (m_highThresh)  ; 

//  get  image  from  received  observation 
byte []  rawimage  =  dm . getValue ( ) ; 

InputStream  rawImageStream  =  new 
ByteArraylnputStream (rawimage)  ; 

Buf feredlmage  image  =  null; 

//  create  buffered  image  from  received  image 

try  { 

image  =  ImagelO . read (rawImageStream) ; 

}  catch  (IOException  e) { 

Logging . log (LogService . LOG_ERROR, "edgeDetector :  error 
processing  input  image:  %s",  e . getMessage ()) ; 

return  dm; 

} 

//apply  detector  to  received  image 
detector . setSourcelmage (image) ; 
detector . process () ; 

//  get  resulting  edge  image 

Buf feredlmage  edges  =  detector . getEdgesImage () ; 

//  do  some  converting,  image  is  ARGB,  but  need  RGB  for 

jpg 
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Buf feredlmage  img  =  new  Buf feredlmage (edges . getWidth () , 
edges . getHeight ()  ,  Buf feredlmage . TYPE_INT_RGB) ; 

img . setRGB (0 ,  0,  edges . getWidth () ,  edges . getHeight () , 

edges . getRGB (0 ,  0,  edges . getWidth () ,  edges . getHeight () ,  null,  0, 
edges . getWidth ())  ,  0,  edges . getWidth ()) ; 

//convert  image  to  byte  array  for  insertion  into  digital 
media  object 

ByteArrayOutputStream  baos  =  new  ByteArrayOutputStream () ; 
byte[]  edgelmageBytes  =  null; 
try  { 

ImagelO . write (img,  "jpg",  baos); 

baos . flush ( ) ; 

edgelmageBytes  =  baos . toByteArray ( ) ; 

baos . close ( ) ; 

//  output  image  to  file  for  testing  purposes 

//  ImagelO . write (img,  "jpg",  new 
File  ( "  .  WWhatlsHappening .  jpg"  )  )  ; 

}  catch  (IOException  e) { 

Logging . log (LogService . LOG_ERROR, "edgeDetector :  error 
converting  edge  profile  image:  %s",  e . getMessage () ) ; 

return  dm; 


} 

DigitalMedia  dmEdge  =  new  DigitalMedia (edgelmageBytes , 

" image/ jpg" ) ; 

return  dmEdge; 

} 

j  *  * 

*  This  class  was  created  and  released  into  the  public  domain 
by  Tom  Gibara,  and  found  from: 

*  http : / / www . tomgibara . com/ computer-vision/ canny-edge- 
detector 

■k 

*/ 


public  class  CannyEdgeDetector  { 
//  statics 


private  final  static  float  GAUSSIAN_CUT_OFF  =  0.005f; 
private  final  static  float  MAGNITUDE_SCALE  =  100F; 
private  final  static  float  MAGNITUDE_LIMIT  =  1000F; 
private  final  static  int  MAGNITUDE_MAX  =  (int) 
(MAGNITUDE_SCALE  *  MAGNITUDE_LIMIT) ; 


//  fields 


private  int  height; 
private  int  width; 
private  int  picsize; 
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private 

private 

private 

private 


int [ ]  data; 
int[]  magnitude; 

Buf feredlmage  sourcelmage; 
Buf feredlmage  edgeslmage; 


private 

private 

private 

private 

private 


float  gaussianKernelRadius ; 
float  lowThreshold; 
float  highThreshold; 
int  gaussianKernelWidth; 
boolean  contrastNormalized; 


private 

private 

private 

private 


float  []  xConv; 
float  []  yConv; 
float  []  xGradient; 
float  []  yGradient; 


//  constructors 


/  ** 

*  Constructs  a  new  detector  with  default  parameters. 
*/ 


public  CannyEdgeDetector ( )  { 

lowThreshold  =  2.5f; 
highThreshold  =  7.5f; 
gaussianKernelRadius  =  2f; 
gaussianKernelWidth  =  16; 
contrastNormalized  =  false; 

} 

//  accessors 

/  -k  -k 

*  The  image  that  provides  the  luminance  data  used  by 
this  detector  to 

*  generate  edges. 

k 

*  Qreturn  the  source  image,  or  null 

V 

public  Buf feredlmage  getSourcelmage ()  { 

return  sourcelmage; 

} 

/  k  k 

*  Specifies  the  image  that  will  provide  the  luminance 
data  in  which  edges 

*  will  be  detected.  A  source  image  must  be  set  before 
the  process  method 

*  is  called. 

* 

*  @param  image  a  source  of  luminance  data 

*/ 

public  void  setSourcelmage (Buf feredlmage  image)  { 
sourcelmage  =  image; 

} 
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I  k  * 

*  Obtains  an  image  containing  the  edges  detected  during 
the  last  call  to 

*  the  process  method.  The  buffered  image  is  an  opaque 
image  of  type 

*  Buf feredlmage . TYPE_INT_ARGB  in  which  edge  pixels  are 
white  and  all  other 

*  pixels  are  black. 

k 

*  Qreturn  an  image  containing  the  detected  edges,  or 
null  if  the  process 

*  method  has  not  yet  been  called. 

V 


public  Buf feredlmage  getEdgesImage ()  { 

return  edges Image; 

} 


j  kk 

*  Sets  the  edges  image.  Calling  this  method  will  not 
change  the  operation 

*  of  the  edge  detector  in  any  way.  It  is  intended  to 
provide  a  means  by 

*  which  the  memory  referenced  by  the  detector  object  may 
be  reduced. 


null 


*  Qparam  edgeslmage  expected  (though  not  required)  to  be 


*/ 


public  void  setEdgesImage (Buf feredlmage  edgeslmage)  { 
this . edgeslmage  =  edgeslmage; 

} 

I  k  k 

*  The  low  threshold  for  hysteresis.  The  default  value  is 

2.5. 

* 

*  ^return  the  low  hysteresis  threshold 
*/ 


public  float  getLowThreshold ( )  { 

return  lowThreshold; 

} 

j  k  k 

*  Sets  the  low  threshold  for  hysteresis.  Suitable  values 
for  this  parameter 

*  must  be  determined  experimentally  for  each 
application.  It  is  nonsensical 

*  (though  not  prohibited)  for  this  value  to  exceed  the 
high  threshold  value. 

* 

*  Qparam  threshold  a  low  hysteresis  threshold 

V 
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public  void  setLowThreshold ( float  threshold)  { 

if  (threshold  <  0)  throw  new 

IllegalArgumentException ()  ; 

lowThreshold  =  threshold; 

} 

/  -k  -k 

*  The  high  threshold  for  hysteresis.  The  default  value 

is  7.5. 

k 

*  Qreturn  the  high  hysteresis  threshold 
*/ 

public  float  getHighThreshold ()  { 

return  highThreshold; 

} 

j  k  k 

*  Sets  the  high  threshold  for  hysteresis.  Suitable 
values  for  this 

*  parameter  must  be  determined  experimentally  for  each 
application.  It  is 

*  nonsensical  (though  not  prohibited)  for  this  value  to 
be  less  than  the 

*  low  threshold  value. 

* 

*  Qparam  threshold  a  high  hysteresis  threshold 
*/ 

public  void  setHighThreshold (float  threshold)  { 

if  (threshold  <  0)  throw  new 

IllegalArgumentException ()  ; 

highThreshold  =  threshold; 

} 

/  ** 

*  The  number  of  pixels  across  which  the  Gaussian  kernel 
is  applied. 

*  The  default  value  is  16. 

k 

*  Qreturn  the  radius  of  the  convolution  operation  in 

pixels 

*/ 

public  int  getGaussianKernelWidth ()  { 

return  gaussianKernelWidth; 

} 

/** 

*  The  number  of  pixels  across  which  the  Gaussian  kernel 
is  applied. 

*  This  implementation  will  reduce  the  radius  if  the 
contribution  of  pixel 

*  values  is  deemed  negligable,  so  this  is  actually  a 
maximum  radius. 
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*  Qparam  gaussianKernelWidth  a  radius  for  the 
convolution  operation  in 

*  pixels,  at  least  2. 

*/ 

public  void  setGaussianKernelWidth (int 
gaussianKernelWidth)  { 

if  (gaussianKernelWidth  <  2)  throw  new 
IllegalArgumentException ()  ; 

this . gaussianKernelWidth  =  gaussianKernelWidth; 

} 

/  k  k 

*  The  radius  of  the  Gaussian  convolution  kernel  used  to 
smooth  the  source 

*  image  prior  to  gradient  calculation.  The  default  value 

is  16. 

k 

*  Qreturn  the  Gaussian  kernel  radius  in  pixels 
*/ 

public  float  getGaussianKernelRadius ()  { 

return  gaussianKernelRadius ; 

} 

/  ** 

*  Sets  the  radius  of  the  Gaussian  convolution  kernel 
used  to  smooth  the 

*  source  image  prior  to  gradient  calculation. 

k 

*  Qreturn  a  Gaussian  kernel  radius  in  pixels,  must 
exceed  0 . If . 

*/ 

public  void  setGaussianKernelRadius (float 
gaussianKernelRadius)  { 

if  (gaussianKernelRadius  <  O.lf)  throw  new 
IllegalArgumentException ()  ; 

this . gaussianKernelRadius  =  gaussianKernelRadius; 

} 

j  k  k 

*  Whether  the  luminance  data  extracted  from  the  source 
image  is  normalized 

*  by  linearizing  its  histogram  prior  to  edge  extraction. 
The  default  value 

*  is  false. 

k 

*  Qreturn  whether  the  contrast  is  normalized 
*/ 

public  boolean  isContrastNormalized ()  { 

return  contrastNormalized; 

} 

/  ** 

*  Sets  whether  the  contrast  is  normalized 
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*  Qparam  contrastNormalized  true  if  the  contrast  should 
be  normalized, 

*  false  otherwise 
*/ 

public  void  setContrastNormalized (boolean 
contrastNormalized)  { 

this . contrastNormalized  =  contrastNormalized; 

} 

//  methods 

public  void  process ()  { 

width  =  sourcelmage . getWidth ( ) ; 
height  =  sourcelmage . getHeight () ; 
picsize  =  width  *  height; 
initArrays ( ) ; 
readLuminance () ; 

if  (contrastNormalized)  normalizeContrast () ; 
computeGradients (gaussianKernelRadius , 
gaussianKernelWidth) ; 

int  low  =  Math. round (lowThreshold  *  MAGNITUDE_SCALE) ; 
int  high  =  Math. round (  highThreshold  * 

MAGNITUDE_SCALE)  ; 

perf ormHysteresis (low,  high); 
thresholdEdges () ; 
writeEdges (data) ; 

} 

//  private  utility  methods 

private  void  initArrays ()  { 

if  (data  ==  null  | |  picsize  !=  data. length)  { 
data  =  new  int [picsize] ; 
magnitude  =  new  int  [picsize]; 

xConv  =  new  float [picsize] ; 
yConv  —  new  float  [picsize]; 
xGradient  =  new  float [picsize] ; 
yGradient  =  new  float [picsize] ; 

} 

} 

//NOTE:  The  elements  of  the  method  below  (specifically 
the  technique  for 

//non-maximal  suppression  and  the  technique  for  gradient 
computation) 

//are  derived  from  an  implementation  posted  in  the 
following  forum  (with  the 

//clear  intent  of  others  using  the  code) : 

// 

http : / / forum. java . sun . com/ thread . j  spa?threadID=54  62 ll&start=45&ts 
tart=0 

//My  code  effectively  mimics  the  algorithm  exhibited  above. 
//Since  I  don't  know  the  providence  of  the  code  that  was 
posted  it  is  a 
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//possibility  (though  I  think  a  very  remote  one)  that  this 
code  violates 

//someone's  intellectual  property  rights.  If  this  concerns 
you  feel  free  to 

//contact  me  for  an  alternative,  though  less  efficient, 
implementation . 


private  void  computeGradients ( float  kernelRadius ,  int 
kernelWidth)  { 


//generate  the  gaussian  convolution  masks 
float  kernel []  =  new  float [kernelWidth] ; 
float  diffKernel[]  =  new  float [kernelWidth] ; 
int  kwidth; 

for  (kwidth  =  0;  kwidth  <  kernelWidth;  kwidth++)  { 
float  gl  =  gaussian (kwidth,  kernelRadius); 
if  (gl  <=  G AU S S I AN_C U T_OF F  &&  kwidth  >=  2)  break; 
float  g2  =  gaussian (kwidth  -  0.5f,  kernelRadius); 
float  g3  =  gaussian (kwidth  +  0.5f,  kernelRadius); 
kernel [kwidth]  =  (gl  +  g2  +  g3)  /  3f  /  (2f  * 
(float)  Math. PI  *  kernelRadius  *  kernelRadius); 

diffKernel [kwidth]  =  g3  -  g2 ; 

} 


int  initX  =  kwidth  -  1; 

int  maxX  =  width  -  (kwidth  -  1) ; 

int  initY  =  width  *  (kwidth  -  1); 

int  maxY  =  width  *  (height  -  (kwidth  -  1)); 


//perform  convolution  in  x  and  y  directions 
for  (int  x  =  initX;  x  <  maxX;  x++)  { 

for  (int  y  =  initY;  y  <  maxY;  y  +=  width)  { 
int  index  =  x  +  y; 

float  sumX  =  data [index]  *  kernel [0]; 

float  sumY  =  sumX; 

int  xOffset  =  1; 

int  yOffset  =  width; 

for(;  xOffset  <  kwidth  ;)  { 

sumY  +=  kernel [xOffset]  *  (data [index  - 
yOffset]  +  data[index  +  yOffset]); 

sumX  +=  kernel [xOffset]  *  (data [index  - 
xOffset]  +  data[index  +  xOffset]); 

yOffset  +=  width; 
xOf f set++; 

} 

yConv [ index]  =  sumY; 
xConv [index]  =  sumX; 

} 


} 

for  (int  x  =  initX;  x  <  maxX;  x++)  { 

for  (int  y  =  initY;  y  <  maxY;  y  +=  width)  { 
float  sum  =  Of; 
int  index  =  x  +  y; 
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for  (int  i  =  1;  i  <  kwidth;  i++) 

sum  +=  dif fKernel [i]  *  (yConv [index 

-  yConv [index  +  i]); 

xGradient [ index]  =  sum; 

} 

} 

for  (int  x  =  kwidth;  x  <  width  -  kwidth;  x++)  { 

for  (int  y  =  initY;  y  <  maxY;  y  +=  width)  { 
float  sum  =  O.Of; 
int  index  =  x  +  y; 
int  yOffset  =  width; 
for  (int  i  =  1;  i  <  kwidth;  i++)  { 

sum  +=  dif fKernel [i]  *  (xConv[index 
yOffset]  -  xConv[index  +  yOffset]); 

yOffset  +=  width; 

} 

yGradient [ index]  =  sum; 

} 


} 


initX  =  kwidth; 

maxX  =  width  -  kwidth; 

initY  =  width  *  kwidth; 

maxY  =  width  *  (height  -  kwidth) ; 

for  (int  x  =  initX;  x  <  maxX;  x++)  { 

for  (int  y  =  initY;  y  <  maxY;  y  +=  width)  { 
int  index  =  x  +  y; 
int  indexN  =  index  -  width; 
int  indexS  =  index  +  width; 
int  indexW  =  index  -  1 ; 
int  indexE  =  index  +  1 ; 
int  indexNW  =  indexN  -  1; 
int  indexNE  =  indexN  +  1; 
int  indexSW  =  indexS  -  1; 
int  indexSE  =  indexS  +  1; 


float  xGrad  =  xGradient [ index] ; 
float  yGrad  =  yGradient [ index] ; 
float  gradMag  =  hypot (xGrad,  yGrad) ; 


yGradient [indexN] ) ; 
yGradient [indexS] )  ; 
yGradient [indexW] ) ; 
yGradient [indexE] )  ; 
yGradient [indexNE] ) 


//perform  non-maximal  supression 
float  nMag  =  hypot (xGradient [ indexN] , 

float  sMag  =  hypot (xGradient [indexS] , 

float  wMag  =  hypot (xGradient [ indexW] , 

float  eMag  =  hypot (xGradient [ indexE] , 

float  neMag  =  hypot (xGradient [ indexNE] , 
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float  seMag  =  hypot (xGradient [ indexSE] , 


yGradient [indexSE] )  ; 

float  swMag  =  hypot (xGradient [ indexSW] , 

yGradient [indexSW] )  ; 

float  nwMag  =  hypot (xGradient [ indexNW] , 

yGradient [indexNW] )  ; 

float  tmp; 


/* 

k 

An  explanation  of  what's  happening  here. 

for  those  who  want 

k 

to  understand  the  source:  This  performs 

the  "non-maximal 

k 

supression"  phase  of  the  Canny  edge 

detection  in  which  we 

k 

need  to  compare  the  gradient  magnitude  to 

that  in  the 

k 

direction  of  the  gradient;  only  if  the 

value  is  a  local 

k 

maximum  do  we  consider  the  point  as  an 

edge  candidate. 

k 

k 

We  need  to  break  the  comparison  into  a 

number  of  different 

k 

cases  depending  on  the  gradient  direction 

so  that  the 

k 

appropriate  values  can  be  used.  To  avoid 

computing  the 

k 

gradient  direction,  we  use  two  simple 

comparisons:  first  we 

k 

check  that  the  partial  derivatives  have 

the  same  sign  (1) 

k 

and  then  we  check  which  is  larger  (2) .  As 

a  consequence,  we 

k 

have  reduced  the  problem  to  one  of  four 

identical  cases  that 

k 

each  test  the  central  gradient  magnitude 

against  the  values  at 

k 

two  points  with  'identical  support';  what 

this  means  is  that 

*  the  geometry  required  to  accurately 
interpolate  the  magnitude 

*  of  gradient  function  at  those  points  has 


an  identical 

k 

geometry  (upto  right-angled- 

rotation/reflection) . 

k 

When  comparing  the  central  gradient  to  the 

two  interpolated 

k 

values,  we  avoid  performing  any  divisions 

by  multiplying  both 

k 

sides  of  each  inequality  by  the  greater  of 

the  two  partial 

k 

derivatives.  The  common  comparand  is 

stored  in  a  temporary 

k 

variable  (3)  and  reused  in  the  mirror  case 

(4)  . 

k 
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/*  (2) */ 


*/ 

if  (xGrad  *  yGrad  <=  (float)  0  /*(!)*/ 

?  Math . abs (xGrad)  >=  Math . abs (yGrad) 


>=  Math . abs (yGrad 
(xGrad  +  yGrad)  * 
>=  Math . abs (xGrad 
(yGrad  +  xGrad)  * 
/*  (2) */ 


*  neMag 


?  (tmp  =  Math . abs (xGrad  *  gradMag) ) 
(xGrad  +  yGrad)  *  eMag)  / *  ( 3 ) * / 

&&  tmp  >  Math . abs (yGrad  *  swMag 


wMag)  /*  (4 ) */ 

:  (tmp  =  Math . abs (yGrad  *  gradMag)) 
*  neMag  -  (yGrad  +  xGrad)  *  nMag)  /*(3)*/ 

&&  tmp  >  Math . abs (xGrad  *  swMag 

sMag)  /* (4  )  */ 

:  Math . abs (xGrad)  >=  Math . abs (yGrad) 


?  (tmp  =  Math . abs (xGrad  *  gradMag)) 
>=  Math . abs (yGrad  *  seMag  +  (xGrad  -  yGrad)  *  eMag)  / *  ( 3 ) * / 

&&  tmp  >  Math . abs (yGrad  *  nwMag 

(xGrad  -  yGrad)  *  wMag)  / *  ( 4 ) * / 

:  (tmp  =  Math . abs (yGrad  *  gradMag)) 
>=  Math . abs (xGrad  *  seMag  +  (yGrad  -  xGrad)  *  sMag)  / *  ( 3 ) * / 

&&  tmp  >  Math . abs (xGrad  *  nwMag 

(yGrad  -  xGrad)  *  nMag)  / *  ( 4 ) * / 

)  { 

magnitude [ index]  =  gradMag  >= 
MAGNITUDE_LIMIT  ?  MAGNITUDE_MAX  :  (int)  (MAGNITUDE_SCALE  * 


gradMag) ; 

//NOTE:  The  orientation  of  the  edge  is 

not  employed  by  this 

//implementation.  It  is  a  simple  matter 

to  compute  it  at 

//this  point  as:  Math . atan2 (yGrad, 

xGrad) ; 

}  else  { 

magnitude [ index]  =  0; 


+ 


+ 


//NOTE:  It  is  quite  feasible  to  replace  the 
implementation  of  this  method 

//with  one  which  only  loosely  approximates  the  hypot 
function.  I've  tested 

//simple  approximations  such  as  Math. abs (x)  +  Math. abs (y) 
and  they  work  fine. 

private  float  hypot (float  x,  float  y)  { 
return  (float)  Math . hypot (x,  y) ; 

} 


private  float  gaussian (float  x,  float  sigma)  { 

return  (float)  Math. exp (— (x  *  x)  /  (2f  *  sigma  * 

sigma) ) ; 

} 


private  void  perf ormHysteresis (int  low,  int  high)  { 

//NOTE:  this  implementation  reuses  the  data  array  to 

store  both 
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//luminance  data  from  the  image,  and  edge  intensity 
from  the  processing. 

//This  is  done  for  memory  efficiency,  other 
implementations  may  wish 

//to  separate  these  functions. 

Arrays . fill (data,  0); 


high) 


int  offset  =  0; 

for  (int  y  =  0;  y  <  height;  y++)  { 

for  (int  x  =  0;  x  <  width;  x++)  { 

if  (data [of f set]  ==  0  &&  magnitude [of f set]  > 

follow(x,  y,  offset,  low); 

} 

of f set++; 

} 

} 


private  voi 
threshold)  { 

int  xO 
int  x2 
int  yO 
int  y2 


follow(int  xl,  int  yl, 

xl  ==  0  ?  xl  :  xl  -  1; 
xl  ==  width  -  1  ?  xl  : 
yl  ==  0  ?  yl  :  yl  -  1 ; 
yl  ==  height  -1  ?  yl  : 


int  il,  int 


xl  +  1 ; 

yi  +  i; 


data[il]  =  magnitude [il] ; 

for  (int  x  =  xO;  x  <=  x2 ;  x++)  { 

for  (int  y  =  yO;  y  <=  y2 ;  y++)  { 

int  i2  =  x  +  y  *  width; 
if  ((y  !=  yl  | |  x  ! =  xl) 

&&  data[i2]  ==  0 

&&  magnitude [ i2 ]  >=  threshold)  { 
follow(x,  y,  i2,  threshold); 

return; 


private  void  thresholdEdges ( )  { 

for  (int  i  =  0;  i  <  picsize;  i++)  { 

data[i]  =  data[i]  >  0  ?  -1  :  OxffOOOOOO; 

} 

} 


private  int  luminance ( float  r,  float  g,  float  b)  { 

return  Math . round (0 . 2 99f  *  r  +  0.587f  *  g  +  0.114f  * 

b)  ; 

} 


private  void  readLuminance ( )  { 

int  type  =  sourcelmage . getType ( ) ; 

if  (type  ==  Buf feredlmage . TYPE_INT_RGB  | |  type  == 
Buf feredlmage . TYPE_INT_ARGB)  { 

int[]  pixels  =  (int[]) 

sourcelmage . getData (). getDataElements ( 0 ,  0,  width,  height,  null) 
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for  (int  i  =  0;  i  <  picsize;  i++)  { 

int  p  =  pixels [i]; 
int  r  =  (p  &  OxffOOOO)  >>  16; 
int  g  =  (p  &  OxffOO)  >>  8; 
int  b  =  p  &  Oxff; 
data[i]  =  luminance (r,  g,  b) ; 

} 

}  else  if  (type  ==  Buf feredlmage . TYPE_BYTE_GRAY)  { 
byte[]  pixels  =  (byte[]) 

sourcelmage . getData ( ) . getDataElement s ( 0 ,  0,  width,  height,  null) 
for  (int  i  =  0;  i  <  picsize;  i++)  { 

data[i]  =  (pixels [i]  &  Oxff); 

} 

}  else  if  (type  ==  Buf feredlmage . TYPE_USHORT_GRAY)  { 
short []  pixels  =  (short []) 

sourcelmage . getData (). getDataElement s ( 0 ,  0,  width,  height,  null) 
for  (int  i  =  0;  i  <  picsize;  i++)  { 

data[i]  =  (pixels[i]  &  Oxffff)  /  256; 

} 

}  else  if  (type  ==  Buf feredlmage . TYPE_3BYTE_BGR)  { 
byte[]  pixels  =  (byte[]) 

sourcelmage . getData (). getDataElement s ( 0 ,  0,  width,  height,  null) 
int  offset  =  0; 

for  (int  i  =  0;  i  <  picsize;  i++)  { 

int  b  =  pixels [offse  t++]  &  Oxff; 
int  g  =  pixels [of fset++]  &  Oxff; 
int  r  =  pixels [offse  t++]  &  Oxff; 
data[i]  =  luminance (r,  g,  b) ; 

} 

}  else  { 

throw  new  IllegalArgumentException ( "Unsupported 
image  type:  "  +  type); 

} 

} 

private  void  normalizeContrast ()  { 

int[]  histogram  =  new  int [256]; 
for  (int  i  =  0;  i  <  data. length;  i++)  { 

histogram [data [i] ] ++; 

} 

int[]  remap  =  new  int  [256]; 
int  sum  =  0; 
int  j  =  0; 

for  (int  i  =  0;  i  <  histogram . length;  i++)  { 

sum  +=  histogram[i] ; 
int  target  =  sum*255/picsize; 

for  (int  k  =  j+1;  k  <=target;  k++)  { 

remap [k]  =  i; 

} 

j  =  target; 

} 

for  (int  i  =  0;  i  <  data. length;  i++)  { 

data[i]  =  remap [data [i] ] ; 

} 
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private  void  writeEdges (int  pixels [])  { 

//NOTE:  There  is  currently  no  mechanism  for  obtaini 
the  edge  data 

//in  any  other  format  other  than  an  INT_ARGB  type 
Buf f eredlmage . 

//This  may  be  easily  remedied  by  providing 
alternative  accessors. 

if  (edgeslmage  ==  null)  { 

edgeslmage  =  new  Buf feredlmage (width,  height, 
Buf feredlmage . TYPE_INT_ARGB)  ; 

} 

edgeslmage . getWritableTile ( 0 ,  0) . setDataElements (0 , 
0,  width,  height,  pixels); 

} 

} 


} 
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package  mil . arl . alg . edgeDetector ; 


import  aQute . bnd . annotation . metatype . Meta . AD ; 
import  aQute . bnd . annotation . metatype . Meta . OCD ; 

@OCD (name  =  "edgeDetector  plug-in")  //  <-  tells  BND  this 
interface  provides  Conf igurationAdmin  data 
public  interface  edgeDetectorConf iglnterf ace  { 

SAD (required=false,  deflt  =  "true")  //  <-  tells  BND  this  is  a 
configuration  attribute  definition,  and  provides  a  default  value 
boolean  Run ( ) ; 

SAD (required=false,  deflt  =  "0.5") 
float  lowThreshold ( ) ; 

SAD (required=false,  deflt  =  "1") 
float  highThreshold ( ) ; 

} 
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Appendix  I.  Open  Standards  for  Unattended  Sensors  (OSUS) 
Plug-in  Compliance  Checklist 
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General  points  for  verification  of  correct  OSUS  plug-in  use: 

Q  Is  the  plug-in  of  the  proper  type  (asset,  extension,  etc.)? 

I  |  Does  the  plug-in  follow  a  proper  naming  convention 
(mil .  arl .  example .  Example  As  set)  ? 

[~|  Is  there  a  user’s  guide? 

I  I  Are  all  nonstandard  dependencies  packaged  properly  into  the  jar,  or 
resources  included? 

I  |  Does  the  documentation  do  any  of  the  following: 

I  I  Contain  background  on  the  plug-in’s  purpose,  any  underlying 
devices,  and  use  cases? 

I  |  Contain  information  on  configuring  the  plug-in,  including 
typical  configurations? 
j  |  Describe  all  configuration  parameters? 

|  |  Contain  information  on  the  dependencies? 

□  Contain  information  on  the  built-in  test? 

□  Describe  a  test  procedure  for  ensuring  proper  operation? 

!  |  Describe  the  data  the  plug-in  produces? 

pH  Describe  the  data  the  plug-in  consumes? 
i  |  Describe  any  error  messages  the  plug-in  could  produce? 

I  ~|  Describe  the  typical  use  cases  of  the  plug-in? 
j  |  Document  the  supported  commands? 

I  |  Have  a  list  of  capabilities?* 

I  I  Contain  a  “quick  start”  guide? 

Verification  checks  in  the  source  code: 

I  I  Does  the  capabilities-xml  accurately  describe  the  plug-in’s 
capabilities?* 

I  I  Are  the  export-package,  include-resources,  and  private -package  set 
properly  in  the  bnd.bnd  file? 

I  |  Are  the  initialize,  activate,  deactivate,  and  update  methods  handled 
properly? 

I  |  Do  all  status  messages  accurately  reflect  the  requested  status? 

I  |  Does  the  built-in  test  (PerformBIT)  accurately  check  the  system 
health? 

I  I  Are  all  data  properly  mapped  to  OSUS  observations  (i.e.,  no  data  in 
wrong  fields)? 

I  |  Is  there  any  specific  code  to  prevent  the  plug-in  from  running  on 
another  operating  system? 

I  I  Is  proper  logging  used  (use  log.logging  not  System.out.print)? 


Asset  plug-ins  only. 
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If  source-code  distribution  is  provided: 

O  Does  the  code  compile? 

I  |  Are  all  necessary  source  files  included  (configlnterface,  scanner,  etc.)? 
I  |  Does  the  newly  compiled  plug-in  boot  and  function  without  errors? 

Verification  checks  from  OSUS-Standard  Graphical  user  interface  (SG): 

i  |  Is  the  plug-in  loaded  into  the  system  and  activated? 

I  I  Is  the  plug-in  accurately  recognized  by  OSUS-SG? 

1  |  Are  all  of  the  necessary  configuration  parameters  visible? 

I  |  Does  the  PerformBIT  return  accurate  information? 

I  I  Does  the  activation  and  deactivation  of  the  plug-in  behave  properly? 
f~|  Does  the  “capture Data"  button  work  properly?* 

I  |  Are  configuration  updates  handles  correctly? 

|  |  Are  the  commands  handled  properly? 

I  I  Do  the  OSUS  observations  contain  all  necessary,  accurate,  and 
relevant  information? 

I  I  If  the  plug-in  consumes  data,  are  the  time-consuming  operations 
handled  on  another  thread? 

I  I  If  data  have  been  mapped  to  an  observation-reserved  field: 

j  |  Is  there  documentation  describing  the  data  and  their  format? 

I  |  Is  there  justification  that  it  could  not  be  accurately  placed  into 
an  existing  field? 


*  Asset  plug-ins  only. 
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List  of  Symbols,  Abbreviations,  and  Acronyms 


ARGB 

alpha-red-green-blue 

ARL 

US  Army  Research  Laboratory 

GUI 

graphical  user  interface 

IDE 

Integrated  Development  Environment 

OSGi 

Open  Source  Gateway  Initiative 

OSUS 

Open  Standard  for  Unattended  Sensors 

PC 

personal  computer 

RGB 

red-green-blue 

SDK 

software  development  kit 

SG 

Standard  GUI 

UGS 

unattended  ground  sensor 

UUID 

universally  unique  identifier 

UVC 

USB  video  class 

XML 

Extensible  Markup  Language 

XSD 

XML  Schema  Definition 
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(PDF)  INFORMATION  CTR 

DTIC  OCA 

2  DIR  ARL 
(PDF)  IMAL  HRA 

RECORDS  MGMT 
RDRL  DCL 
TECH  LIB 

1  GOVT  PRINTG  OFC 
(PDF)  AMALHOTRA 

1  ARL 

(PDF)  RDRL  SES-A 
JTYO 
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